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HOW TO USE THIS BOOK 

The Multios Condensed Guide is intended as a 
quick reference book for a programmer at the 
console. The guide covers commands available 
in Limited Initial Multics (LIM). 

Where possible within a given section, material 
is arranged alphabetically and there is only 

• one topic on a page (a given command or request). 
To locate a command, simply turn to the appro- 
priate section and look it up alphabetically. 

The MCG is looseleaf; changes and additions 
will be made to it as appropriate. In addi- 
tion, the programmer may divide the book into 
sections keeping only those that he needs for 
his console work. 
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SYSTEM CONVENTIONS 



DIALING IN 



No standard digit for dialing into the Multics system 
has yet been assigned. When it is, the user will 
follow the procedure: 

Dial appropriate digit 



Listen for high-pitched tone 

Push DATA button on 2741 and 1050. 
(Automatic on TTY 37.) 




Watch for message from Multics system to be 
printed out 

LOGGING IN 



Once Multics has responded to dialing in, the user 
issues a login command giving his personal name and 
project id as in: 

login Smith Multics 



The system asks for a user password. The user types 
in his password, for example: 



corncob 

Multics verifies the password and responds with 
R(eady) message. The user may now issue commands to 
Multi cs. 



LOGGING OUT 



When a user is ready to terminate a console session, 
he issues a logout command, i.e., 

logout 

Multics responds with a W(ait), then issues the 
following message: 

per sonaljname project_i d logged out 




as in: 

Smith Multics logged out 
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SYSTEM CONVENTIONS 



STANDARD SYSTEM RESPONSES 

When the user dials into Multi cs, stand- 
ard system response is: 

MULTI CS in operation on date at t i me 

for example: 

t ULTICS in operation on Wed 8 Nov 1968 at 09:23:18.85666 EST 

Multics may then follow with one or more 
timely messages to users. Multics terminates 
response with a R(eady) message giving timing 
information. For example: 

r 0.1 0.0 0 

where: 




The first group of digits give the amount of 
elapsed real time. 

The second group of digits give the elapsed 
CPU time (used in timing commands). 

The third group of digits give the number of 
times a command waited for a page from a 
storage device. 

In dialing in, as shown in the example, only 
the first group of digits are significant. 

When the user issues a command to Multics the 
usual system response is a W(ait) while Multics 
takes appropriate action. When action is com- 
plete, Multics then issues aR(eady), for example: 

w 929:19.4 

r 7.6 6.2 40 

The number following a wait gives the time of 
day to the tenth of a second. 
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SYSTEM CONVENTIONS 



CONSOLE ACTIVITIES 

When a user logs into Multics, a working direc- 
tory is set up for him. The directory has the 
form: 

>user_d i r__d i r>personal_name . pro ject_i d 

Once the working directory has been set up, the 
user can add entry names of segments to his 
directory using the branch command, or estab- 
lish an entry by writing a segment in one of 
the editors, edm or qed . 

Source programs are written in one of the Multics 
languages by entering either the edm or qed 
editor ( edm or qed command)and either giving a 
new entry name by which the program is to be 
called or using an existing entry name for it. 

The source program segment must be named with 
a second component that is the name of the 
compiler or assembler to be used, e.g., 

edm joe.epl 

qed sourceprog.eplbsa 

edm test. fortran 

Once in an editing system, the user writes his 
source program in the appropriate language. 

The source language program can be compiled 
or assembled by issuing the appropriate 
language command (epl , eplbsa , bcpl , tmgl , 
fortran ) , e . g . , 

epl joe 

eplbsa sourceprog 
fortran test 

After assembly, a program may be executed as 
a command by typing its name and arguments 
(provided all arguments are character 
str ings) , e.g. , 

joe joedata 
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SYSTEM CONVENTIONS 
CONSOLE ACTIVITIES 

If the text segment fails to execute, the 
probe command and appropriate probe requests 
can be used to help debug the program. 

Access control commands ( setae 1 , delacl and 
1 istacl ) allow the user to give other users 
access to contents of his working directory 
for reading, writjng, execut ing,_and appending 
to one or more of his segments. 

Means have been provided in Multics to 
transfer segments back and forth to the older 
GECOS operating system and to transfer 
files on the 7094 CTSS system to the Multics 
system and vice versa. (See tape_in and 
tape_out commands and the merge_edit com- 
mand with merge_edit control lines.) 
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SYSTEM CONVENTIONS 
CONSOLE INTERRUPTS ( QUIT ) 

To stop a process or to .return to command level, 
the user pushes the ATTENTION button once on 
the IBM 2741 and IBM 1050 or the INTERRUPT button 
once on the TTY 37. 

All prior work is saved, so that the user may 
either enter a new system or reenter the system 
he was in when he issued the quit. 

After pushing the appropriate button, the system 
prints out 

quit 

and then 

r(eady) and the time. 

Examp le ; 

The user may be in EDM and wish to quit; the 
response may appear as follows: 

quit 

r 1:01.1 15.1 44 

After a quit, the user may wish to issue either 
a start command or a new_proc command. (The start 
and newj)roc commands are appropriate on ly immediately 
after a quit.) 

The start command allows the user to resume at the 
point he quit and in the system he was in when he quit 
EDM in the example. 

The newjDroc command leaves the user in his previous 
working directory but creates a new process for the 
user. The old process is available for debuggings 
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INPUT STREAM 
CHARACTER ESCAPE CONVENTIONS 

In Multics, all characters to and from external 
devi ces are t rans lated to ASC II by a tab le d r i ven 
coda conversion. Universal character escape 
conventions are provided for each type of console 
or card device attached to the system. However, 
each device may be used with stylized characters 
that represent some internal ASCII characters or 
with escape conventions unique to the device. 

The following pages present the Multics universal 
escape conventions, the stylizations, and the 
escape conventions used with each device. 
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INPUT STREAM 

MULT ICS UNIVERSAL ESCAPE CONVENTIONS 

A. ERASE AND Kl LL CHARACTERS 

The standard erase and kill characters are: 
Meaning 

erase the previous character 
delete the current line 

To represent octal codes, type a "\ T (left slant) 
and up to three octal digits. Example: 

\777 

C. STYLISTIC CONVENTION 

One stylistic convention holds at all consoles. 
The solid vertical bar () ) and the broken verti- 
cal bar (J ) are considered alternatives of the 
graphic for ASCII code value 174. 









Character 

# 

<s> 



B. OCTAL CODES 
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INPUT STREAM 



37KSR TE1 FTYPFS 

There are no further escape conventions 
required for the use of the TTY 37 , since 
it uses the revised ASCII character set. 

IBM 1050 AND 2741 C0NS01 ES 

Each type ball used would require a different 
set of escape conventions. The ball pre- 
sently implemented is the 963 type ball. 

The non-ASCII characters on the 963 type 
ball are considered stylized versions of 
ASCII characters: 



fi (cent sign) 


for 


%% (left slant) 


» (Apostrophe) 


for 


/ t 

(accent acute) 


(negation) 


for 


^ (ci rcumf lex) 



In addition, the following escapes are 
available: 



for 
/k for 
£> for 
for 
fi) for 
fit for 



(accent grave) 

L (left square bracket) 

] (right square bracket) 
{ (left brace) 

} (right brace) 

(over li ne/ti lde) 
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ARGUMENT 



entry 

^Lth 






acname 

i 



COMMAND CONVENTIONS 
FORMATS FOR COMMANDS 

represents a unique entry name (branch or link) 
in the user's working directory, e.g., 

my_seg 

is a general term for an argument that may 
represent one of the following: 

(1) An entry name (branch or link) in the 
user's working directory or in another 
directory. If the entry name is in another 
directory, path must include enough of the 
pathname to the entry so that it can be 
found, e.g., 

my_seg (implicit path to working 

di rectory entry) 

>j°es_di r>zap.epl (explicit path to an 

entry in another directory) 

(2) A directory, indicated by a terminating >; 
path must include enough of the pathname so 
that the directory can be found, e.g., 

>freds_dir> 

where freds_dir is a unique directory in the 
file system. 

is an access control name representing the 
name of a user or set of users. It differs 
from an entry name only in that it must have 
3 components, personal_name, projected, and 
i nstance_tag; for example: 

Andrews. Multics.* (Tag is usually given 

as. *) 
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COMMAND CONVENTIONS 
SYMBOLS USED IN COMMANDS 





* Used to match any one component of a name 
(pathname, entry name, access control name) 
found in a list of names, for example, 

li st my_di r>my_ entry>' )( ".my_seg 

might cause the listing the following 
names from the directory given as my_entry: 

Branches 

versionl .my__seg 
ver sion 2 .my_seg 
ver s i on3 . my_seg 
newver s.my_seg 
last_t ry.my_seg 

** Used in a terminating position to match 

any number of components of an argument, i.e., 

list my_di r>alpha.** 

causes listing pathnames from my__dir. 

These might be: 

Branches 

alpha 
alpha. 1 i nk 
alpha, beta, ep 1 

Links 

alpha. rev >joe_di r>beta 
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COMMAND CONVENTIONS 



Separates components of entry names. Components 
may be without special significance, e. g., 

my_seg.a or my_seg.b 

However, many components have special meanings. 
When writing a source program in EDM or QED, the 
second component of the name indicates the com- 
piler or assember to be used to translate the 
source program, e.g., 

edrn my_seg.bcpl 

When the command to compile the source program 
is given the command is: 

be pi my_seg 

Compilation and assembly that follow the bcpl 
command create the following segments: 

my_seg (text segment) 

my_seg.link (linkage segment) 

my_seg. symbol (symbol table) 

With certain options in effect, the same command 
could also create: 



my_seg. list (ascii listing) 

my_seg. error (error segment) 

When my_seg is executed, the command is simply 
the text segment name followed by appropriate 
string arguments. 

The user can combine text, linkage, and symbol 
segments into a single object segment, e.g., 

my_seg. object 

Compilation, assembly, and execution of a seg- 
ment can be done with merge_edit and the GECOS 
system. A segment containing merge_edit instruc- 
tions is set up using EDM or QED. The first com- 
ponent of the entry name can optionally be that 
of the text segment; the second component is 
gecos, e.g., edm my_seg.gecos 
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COMMAND CONVENTIONS 
SYMBOLS USED IN COMMANDS 




> 



Used only in the second argument of a command when 
similar components appear in the arguments. 

= means duplicate the cor respondi ng component of the 
first argument, e.g. , 

rename my_seg.epl =.pl 

Used only in the second argument of a command. 

== means duplicate all components following as taken 
from the first argument, e.g., 

rename my_seg.epl.link your_seg.== 

/ 

Used in describing a pathname as follows: 

>a an initial > designates an absolute pathname, 
i.e., one fixed with respect to the root 
directory. (The > is the abbreviated name of 
the root directory.) 



< 




a> a terminal > indicates the entry immediately 
preceding is a directory. 

a>b infix > is used to show the path down to the 

required entry. The terminating entry may be 
itself a directory but as used here is treated 
as a terminating entry. 

Note that if the path, a>b, does not begin 
with >, then a is presumed to be in the current 
working directory. 

Used in a pathname to describe motion up the 
directory hierarchy. >a>b>c<d means to follow the 
file system hierarchy down to c, then return to the 
directory containing c and progress down to d. 

The effective result is >a>b>d. This is especially 
useful in the case: 

<a>b 

which indicates entry b in directory a in the same 
directory that contains the current working directory. 
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COMMAND CONVENTIONS 
SYMBOLS USED IN COMMANDS 



0 




[] 



l[] 




Parentheses delimit a set of iteration 
elements. Each element in the set is 
inserted in turn into the enclosing 
command and the command is evaluated. 

See the following paragraph on brackets 
for an example. 

Used as command delimiters. The en- 
closed character string is evaluated 
as a command and its value inserted in 
the command line; for example: 

print ([files *.epl ]) 

The files command is evaluated and the 
values returned inserted in the command 
line. When files is evaluated, the print 
command might read: 

print (a.epl b.epl c.epl) 

Each of the three segments will then be 
printed in turn by the print command 
(because of the parentheses permitting 
iteration.) 

When a command in brackets is evaluated, 
the value is reexamined for further 
del im i ters 

When a single vertical bar precedes a 
command in brackets, the value of the 
command is inserted into the command line 
but the command is not reexamined for 
further delimiters. 
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COMMAND CONVENTIONS 

SYMBOLS USED IN COMMANDS 

I I [] When double vertical bars precede a 

command in brackets, the command is 
evaluated but the value is not in- 
serted into the command line. (The 
double vertical bar convention is 
the equivalent of an interjected 
command in the previous command 
language.) 

space Command elements must be delimited 
by spaces. Defined delimiters need 
not be separated from enclosed ele- 
ments by spaces, e.g., [ x ] = [x]. 

Absence of a space between a delimiter 
and the rest of an element outside the 
delimiter indicates concatenation, e.g., 
>a>b>(c d e) indicates three pathnames: 

>a>b>c, >a>b>d, and >a>b>e. 

Left and right accents denote a literal 
string. 

II n Double quotation marks also denote a 

literal string. However, a literal 
string enclosed in double quotation marks 
cannot be nested in another literal string 
also enclosed in double quotation marks. 

NL The end of a command is delimited by an 
ASCII new line character. On the TTY37 
NL is indicated by pressing the 
LINE SPACE key; on the 2741 NL is indi- 
cated by pressing the RETURN key. 

; A command delimiter, permitting commands 
to be stacked before execution. The 
commands are executed when an NL is 
encountered. 
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ADDNAME 
Format : 
Purpose : 

Notes : 




Example: 




Reference : BX. 8. 09 
addname path entry 

To add an alternate entry name, entry to 
the existing entry name specified by 
path . 

Execute and write attributes must be on 
in the directory containing path . 

Equals convention permitted in entry . 

entry must be unique in the directory. 

addname >sys_l i b>Smi th .Mul t i cs. epl Jones. == 

where the name, Jones. Mul t i cs. epl is 
added to the entry, Sm i th. Mul t i cs. epl 
in the directory, sys_ lib. 
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ADJUST 
Format : 

t 

Purpose : 



Example : 



COMMANDS 

Reference : BX. 99. 08 



adjust path 

adjust$test path 
adjust$block path 
adjust$block_test path 
adjust$test_block path 

To correct the bit count for path , a segment 
moved from CTSS to Multics. 

(When a segment is moved, the Multics 
bootload or tape_daemon accepts the ETX that 
marks the end of CTSS file or any trailing 
asci f i NUL characters used in padding as part 
of the initial bit count. The adjust command 
corrects this.) 

Meanings of the formats are: 

adjust path causes computation of bit 
count to and truncation of the segment 
at the last significant word. (Word 

containing characters other than NUL or 
ETX). 

adjust$test path causes only printing of 
diagnostics that would apply if adjust 
were invoked for a bit count. 

adjust$block path uses the current length 
in 1024-word blocks to calculate the 
segment ! s initial position. 

ad just$block test oath , 

adjust$test_block path cause on Y 
printing of diagnostics that would apply 
if adjust$block were invoked. 

adjust >sys_ 1 i b>ctsf i 1 

where segment, ctsfil, is truncated at the 
last word containing a significant character. 

A bit count is provided. 
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ARCHIVE 
Format : 
Purpose: 






Notes: 



Examples: 



COMMANDS 

Ref erence: BX.9.04 

archive key path entryl ... entrvn 

To create, replace, delete, print headers of, 

- move, or combine segments of archive segment 
path , where the segments are given by entryl . . . 
entrvn . The name of an archive segment will 
have .archive appended if not already present. 

key is one of the following: 
d delete entryl . . .entrvn f rom path 

r replace old entryl to entryn with entryl . . . 
entryn . If an entry does not exist, it is 
added to the end of path . An r key can be 
used to create an archive segment path , if 
none exists. 

rd remove entryl . . , entryn from current working 
directory and place them in the archive 
segment given by path . 

t print headers of entryl . . .entryn in path . If 
no entries are given, all headers in path 
are printed. 

x extract entryl .. .entryn from path and copy 
the entries into the directory of path . 
path is unchanged. 

Error messages are printed for: 
key other than d, r rd, t, or x 
path not an archive file 
path does not exist (with d or x) 

entry cannot be found or cannot be moved (e.g., 
entry already exists on an x request) 

Secondary name .object on a segment means that 
text, link, and symbol segments are to be 
treated. 

archive r my a b cc v 

creates segment my. archive with components a, b, 
and cc. 

archive d my alpha. object 

deletes alpha, alpha. link, and alpha. symbol 
f rom my .arch ive. 
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COMMANDS 

BCPL Reference: BX.7.06 

Format: bcpl path options 



Purpose:To compile the source file, path , 
using BCPL. 






Options: old 



li stty 
errtty 



compiler accepts old 
(CTSS) BCPL syntax. 

list the source segment 
on-line rather than in a 
special list segment. 

produce source code error 
comments on-line rather 
than in the path . error 
segment. 



pname produce a cross-referenced 
list of occurrences of each 
identifier in the program 
as part of the source seg- 
ment. 



nobsa BCPL does not call EPLBSA 
assembler when compilation 
is done. Text and link 
segments are not produced. 

Primary output is a com- 
piled segment called 
path .eplbsa in the working 
directory. 

savebsa the compiled segment, 

path. ep lbsa. is left in the 
working directory and can 
be assembled at a later time. 

Used when EPLBSA is called 
after compilation (no nobsa option). 




Example: bcpl >system_library_1>shortprog errtty nobsa 
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COMMANDS 


BIND 


Reference: BX. 99-13 


Format: 


bind path 


Purpose: 

t 


To bind together the object 
segments contained in the 
archive segment specified by 
path. Two entries are created 
in the user ! s working directory 
by the command: 


I - . 


path - a bound segment 

composed of all the 
segments from path. arch ive. 




path. map - map of the bound segment. 


Note: 


The components of the archive segment 
must all be in object format and 
must have linkage and symbol sections. 


Example: 


Assume alpha. archive is an archive 
file in the current working 
directory. Then 




bind alpha 


§ 


creates alpha and alpha. map, 
where alpha is the bound 
segment. 


- 
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BRANCH 
Format : 
Purpose: 




Notes: 



Example: 



COMMANDS 

Reference BX. 8.06 
branch path 

To create an entry name in 
some directory. The entry name 
can be specified as either a 
directory name (terminated 
by >) or an non-directory 
name (no terminating >) . In 
either case the entry is 
designated as a branch. 

Append mode is necessary in 
the directory to which path 
i s to be added. 

See LINK command for creation 
of links. 

branch >user_di r_di r>di r l>di r2> 

where dir2 is the directory entry 
added to the directory 
path given as 

>user dir dir>dirl 
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COMMANDS 

CHANGE WD I R Reference: BX. 8 . 14 A 




Format: change_wdir path 

Purpose: To change the name of the user’s 

working directory to the 
pathname given by path . 

Examples: change_wdir >user_di r d i r>Stone. Mu It i cs 

change_wdir <Mart in . Mu It i cs 
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CHASEPATH 



COMMANDS 

Reference: BX. 8 . 13 



Format : 
Purpose : 




Notes : 
Examples : 



chasepath path 

To retrieve the full and final pathname 
of the entry, path . 

Read mode required in path . 

chasepath f red 

If f red is an entry in a directory 
branch of the working directory, 

>user_di r d i r>user , the example 

returns the character string: 

>user_di r d i r>user>f red 

I f f red i s a link to 

>user_di r d i r>other_user>f r i tz 

which is a link to 

>user_di r d i r>thi rd_user>derf 

then chasepath returns the character 
string value: 

>user_di r d i r> t h i rd_user>derf 

To obtain the value at the terminal 
give the command 

echo [chasepath fred] 
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COMMANDS 




CONTENTS Reference: MCB-275 

Format: contents path 

c path 

Purpose: To return as a character string the 

entire contents of the segment given 
by path . 

Notes: The command makes possible the execu- 

tion of a set of commands that have been 
typed into a segment, or the selection 
from a segment of a list of arguments 
to a command, etc. 

If a segment is to be used as a set of 
commands, then each command in the seg- 
ment must be separated from the next by 
a ; (semicolon) . 

There are two methods of delimiting the 
commands which are to be executed. The 
first character and last character in 
the segment path can be [ and ] respec- 
tively, in which case typing: 

contents path 

is sufficient. In the second method, 
the user may type: 

[contents path 1 

The segment path need not begin and end 
with square brackets if the second method 
is used. 

Example: Assume the following contents of seg- 

ment x: 

abed 

Then the command: 

remove ([contents x])(() .(link symbol)) 

removes segments: 

a a. link a. symbol 

b b.link b. symbol 

c c.link c. symbol 

d d.link d. symbol 
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COMMANDS 

CON VE RT_OB J E CT Reference: MCB-275 

Format: convert_object path 




Purpose: To convert path , path . 1 ink, and 

path . symbol to a single "object" 
segment . 

Notes: If a text segment exists, an object 

segment is created whether or not 
link and symbol segments are present. 
Either symbol only, or link and sym- 
bol may be missing. The command 
comments about missing segments. 

Example: conver t_ob ject alpha 

If alpha was compiled in epl with 
alpha, alpha. link, and alpha. symbol 
being created at that time, then the 
command will create a single segment, 
alpha. object . 




111-17 Rev 2 06019 





COMPARES 



COPY Reference: BX.8. 11 

Format: copy pat hi path2 

Purpose: To copy the branch entry, given by 

pathl into the branch entry named 
in pa th2 * thus creating the new 
branch. The entry pointed to by 
path2 must not exist before issuing 
the command. 



Notes: Read mode is required for pathl ; 

write and append modes required 
for the directory containing path2 . 



The equals convention may be 
used. 

Example: copy >old_di r>f red. link george.= 

Branch, fred.link, in the direc- 
tory, >old_dir, is copied into 
the working directory as 
george. link. 
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COMMANDS 

CTSS_AARCHV Reference: MCB-275 



Format : 
Purpose : 




Notes : 



Example : 



ctss_aarchv path>segname1 . segname2 

To extract all segments from a CTSS 
ascii archive file and place them in 
the current working directory. 

segnamel and segname2 are the first 
and second components of the CTSS file 
name. If path is not given, the 
CTSS archive file containing the 
segment is presumed to be in the 
working directory. 

ctss_aarchv finds the real names of 
the segments if the archive file is an 
epl or eplbsa file and renames the 
extracted segments to their real names, 
or if the real names are not found, 
they are renamed to their CTSS name. 

To use the command for non-epl/eplbsa 
file, rename seaname2 to epl or eplbsa. 
The resulting segments will have the 
following name format: 

ctss_name1 .epl or 
ctss_name1 . eplbsa 
ctss_aarchv alpha. eplbsa 
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COMMANDS 



Jotes: 



DELACL Reference: BX.8.02 

Format: delacl path acnamel . . . acname 

Purpose: To delete the access control names 

acnamel ... acnamen. from the ACL of the 
entry defined by oath or from the CACL of 
di r if path is terminated by dir>. 
path may be a path name, entry name or set 
of entry names defined by the * convention. 
acnamel . . . acnamen each have the form: 

per sonal_name.project_name. tag 

where tag is the instance tag of the 
process-group in which user is currently 
working and is usually indicated by * for 
any instance tag. An acname might be: 

Brown. Mu It ics.* 

Notes: Omission of an acname argument causes an error 

comment . 

If an acname does not appear in the appropri- 
ate ACL, delacl prints a comment and processes 
the next acname. 

See setacl command for required access needed 
to delete access control names. 

Example: delacl g bcpl Doe. Mu It i cs.* Smith, Mu It i cs.^ 

where g_bcpl is an entry in the user’s 
directory. Access control names Doe. Mult ics. 5 
and Smith. Multics.* will be removed from the 
ACL of g_bcpl. 

delacl dir_bcpl> Brown. Multics.* 

dir_bcpl is a directory within the user's 
working directory. Access control name 
Brown .Mult ics .* is removed from the CACL 
of dir_bcpl. 

Restriction: Because delacl has not yet been imple- 

mented as described above, use the following 
format for deleting access control names from 
the CACL of a directory, some_d i r . 

change_wd i r >s ome_d i r 
delacl "" acnames 
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DELNAME 
Format : 
Purpose : 




Example : 



COMMANDS 

Reference: BX.8. 10 
del name path 

To delete an entry name specified 
by path . The entry specified by 
path must not be the only name on the 
entry. 

delname my_seg.list 

where my__seg.list is an entry name 
in the user’s working directory. 
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DPR I NT 
Format : 
Purpose: 




Notes: 



Examp le: 



COMMANDS 

Reference: BX.5.03 

dprint pat hi path2 pathn 

To queue segments given by pat hi 
to pat hn for delayed printing by the 
output driver daemon. 

The segments are copied onto the 
printer in the order given. 

Segments to be copied should contain 
Multics standard characters. If a 
segment is missing or has a zero 
length, the segment is skipped. 

dprint alpha beta >joes_d i r>gamma 

Segments alpha and beta from the 
current working directory and 
segment gamma from joes_dir 
directory are queued for printing 
by the output driver daemon. 
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COMMANDS 

DPUNCH Reference: BX.5.03 

Format: dpunch pat hi path2 ... pat hn 



Purpose: 




Notes : 



Examp le: 



To queue segments given by pat hi 
to pathn for delayed punching by the 
output driver daemon. 

The segments are punched in the order 
given. Segments to be punched 
should contain a binary card image 
in every 27 words, i.e., the 960 bits 
per card should reside in the first 
26-2/3 words of each 27 words. 

If a segment is missing or has zero 
length, the segment is skipped. 

dpunch alpha beta >joes_di r>gamma 

Segments alpha and beta from the 
current working directory and segment 
gamma from joes_dir directory are 
queued for punching by the output 
driver daemon. 
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ECHO 
Format : 
Purpose: 



§ 

Examples: 



COMMANDS 

Reference: BX.20.01 

echo str ing 

A system test command. 

Echo types out "echo:” and a 
simple character string argument 
or a literal string argument or 
the character string value of a 
command argument passed to echo. 

echo abc 
echo: abc 

echo a b 
echo : a 

echo 11 a b c n 
echo : a b c 

echo [wdir] 

echo: >user dir d i r>Shi h.Mu It i cs 
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EDM 

Format: 
Purpose : 






Notes : 



Example: 




COMMANDS 

Reference: BX.9 
(Draft at present) 

edm path 

To invoke the EDM editor to create or 
edit an ASCII segment, where: 

path is the optional pathname of a 
segment to be created or the required 
pathname of an existing segment to be 
edited. If only the entry name is 
given, the segment is assumed to be in 
the current working directory. 

If path represents an existing segment, 
the EDM editor begins in edit mode; 
if path represents a segment to be 
created (or if the argument is null), 
the EDM editor begins in input mode. 

See the section on EDM requests for 
further information on input/edit modes 
and how to use EDM. 

If the segment represented by path is a 
procedure for compilation or assembly, 
the name must include the name of the 
compiler or assembler to be used. 

edm testproc.epl 

The segment is in the current working 
directory (or will be created there). 

It will be an epl procedure invoked for 
compilation by: 

epl testproc 
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EPL 



COMMANDS 

Reference: BX.7.08 



Format : 
Purpose: 



t 



Notes : 



Example : 






epl entry 

To invoke the epl_daemon for EPL 
compilation of the source segment, 
entry . in the current working directory. 

When the epl_daemon is invoked, the 
r(eady) message printed at the terminal 
does not indicate that compilation is 
complete. To determine the results of 
compilation as well as to check as to 
whether compilation is completed, the 
command 

print epl_daemon. error 

will cause printing of results of 
compilation. A compilation-done 
message will be added at a later date. 

epl datanal 

where datanal. epl is the entry name of 
an EPL source program in the working 
di rectory. 
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COMMANDS 


EPLBSA 


Reference: BX.7.03 


Format : 


elpbsa entrv 


Purpose: 


To invoke the epl_daemon for EPLBSA 
assembly of the source segment, entry, 
in the current working directory. 


Notes: 


When the epl_daemon is invoked, the 
r(eady) message printed at the terminal 
does not indicate that assembly is 
complete. To determine results of 

assembly as well as to check as to 
whether assembly is completed, the 
command 




print epl_daemon. error 




will cause printing of results of 
assembly. (An assembly-done message 

will be added at a later date.) 


Example : 


eplbsa my_sort 




where my_sort. eplbsa is the entry name 
of an EPLBSA source program in the 
working directory. 


• 
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COMMANDS 



EXP AND Reference: 

Format: expand path mode 



BX. 7.05 

BY. 21. 01 






Purpose: To insert into the segment, 

path , additional segments speci- 
fied in the text of segment path . 
path is scanned for statements 
of the form: 

% include pathname 

where pathname is a segment 
to be inserted. 



Optional argument mode gives the 
access mode of the newly expanded 
path . (TREWA or any subset of 
the Trap, Read, Execute, Write 
and Append modes.) 




Example: expand my_epl RW 

where segment, my_epl, in the 
user's working directory con- 
tains the following: 

my_epl: procj 

statement lj 

% include >user_di r_di r>j'oe_eplj 
statement2j 

% include >user_di r_di r>make_ep 1; 
end my_epl$ 

The command causes segments, joe_epl 
and make_ep 1 to be included as part 
of the newly expanded segment named 
my_ep 1. expanded . 
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EXTRACT ARCHIVE 



COMMANDS 

Reference: BX.99.12 






Format: ext ract_ar chive path>sepname1 . segname2 

Purpose: To extract all segments from a CTSS 

regular archive file, and place them 
in the current working directory. 

segnamel and segname2 are the first 
and second components of the CTSS file 
name. If path is not given, the 
CTSS archive file containing the file 
is presumed to be in the working 
directory. 

Notes: ext ractjarch i ve finds the real names 

of the segments if the archive file 
is an epl or eplbsa file and renames 
the extracted segments to their real 
names, or if the real names are not 
found, they are renamed to their CTSS 
name. 

To use the command for non-epl/eplbsa 
file, rename segname2 to epl or eplbsa. 
The resulting segments will have the 
following name format: 

ctss_name1 .epl or 
ctss_name1 .eplbsa 

Example: extract_archive alpha. epl 
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FI LEI 0 



Format : 
Purpose: 



Notes: 



Examp le: 



COMMANDS 

Reference: BX.5.02 
f i leio path 

To indicate that the user's next 
input lines are to be taken from 
the segment entry, specified by path, 
not from the console. 

The format of input lines in path 
must be the same as if they were to 
be typed at the console. 

When input from path is exhausted, 
the next input line is taken from the 
console. 

fileio >my_li brary>sub_loop 

input will be taken from sub_loop in 
the directory, my_library, until the 
end of the segment. 
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FILES 
Format : 
Purpose : 




Example : 



COMMANDS 

Reference: BX.8.01 
f i les path 

To obtain a list of path names 
of entries within path . The 
command differs from the list 
command in that the list is re- 
turned as a character string and 
path names rather than entry 
names alone are returned. 

print ([files *.epl ]) 

The files command is "nested" in 
the print command. When the 
files command is evaluated, the 
print command might be: 

print (a.epl b.epl c.epl) 

causing the three files to be 
pr inted. 
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FLUSH 
Format : 
Purpose: 



COMMANDS 




Reference: BX.20.03 

flush 

To cause all pages currently 
in core to be paged out. A 
system test command; after 
flushing the system, worst 
case timings can be obtained 
for command execution. 
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FORTRAN 
Format : 
Purpose : 



COMMANDS 




Ref erence : BX . 7 . 02 
fortran path 

To compile and assemble the source 
program segment specified by path using 
the FORTRAN compiler. 

fortran alpha 

where alpha . for tran is a source 
program to be compiled and assembled. 
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COMMANDS 

F S CHNAME Reference: BX.8.16 

Format : f s_chname path entry ol dename newename 




Purpose: To cause one of the names of entry in 

the directory given by path to be 
replaced, deleted or added. This 
command interprets none of the special 
command symbols (e.g., *,>) and thus 
allows manipulation of strangely-named 
segments. 

Notes: When both the old entry name, ol dename , 

and the new entry name, newename . 
appear in the command, newename 
replaces ol dename . 



If ol dename is the null string, 
then newename is added to the list of 
names for the entry. 

If newename is the null string, 
then oldename is deleted from the list 
of names for the entry. 

path must be a complete pathname 
relative to the root. 

Example: fs_chname >user_dir_di-r>my_dir alpha foo 



One of the names of entry alpha in 
directory, my_dir, was foo. This 
entry name is deleted by the command. 
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FS RE A DA CL 



COMMANDS 

Reference: BX.8.17 



t 



Format: fs_readacl path entry 

Purpose: To cause the access control list of 

entry to be printed. path gives the 
absolute (relative to the root) 
pathname of the directory containing 
entry. The command interprets 
none of the special command symbols 
(e.g., *,>) and thus allows manipulation 
of strangely-named segments. 

Notes: If entry is given as a null string, 

i.e., ,,n , the common access control list 
(CACL) of the directory given by, path 
will be printed. 

Examples: fs_readacl >user_di r d i r>my_di r alpha 

causes the ACL of segment alpha in 
directory, my_dir, to be printed. 

fs_readacl >user_di r_di r>my_di r "" 

causes the CACL of directory, my_dir, 
to be printed. 
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COMMANDS 

Reference: BX.5.01, BF.1.01 

iocall outercal 1 ioname arguments 
To issue l/O outer calls from command level. 
outercall is one of the l/O outer calls. 
ioname is a name used to route calls in I/O. 

arguments are other arguments of the given 
outercal 1 . (Shown in table below. Hyphens show 
optional arguments. See BF.1.01 for argument 
information. 



Outercall 


1 oname 


Arguments 




attach 


i oname 


type -mode- ioname2 




detach 


i oname 


-mode- ioname2 




read 


ioname 


worksegment -offset- 


-nelem- 


write 


ioname 


work segment -of fset- 


-nelem- 


seek 


i oname 


ptrnamel -ptrname2- « 


-of fset- 


tell 


i oname 


ptrnamel -ptrname2- 




setsize 
getsi ze 


i oname 
i oname 


elementsi ze 





Notes: Calls to iocall should not be programmed into 
procedures; use a call to outercall . 

Default input and output (called user_i/o) is 
to a console. Either input (user_input) or 
output (user output) can be diverted using 
iocall. 

Examples: iocall attach zz file made_up_name 

creates empty segment zz for subsequent at- 
tachment. 

iocall attach user_output syn zz 

attaches output to segment zz. A w(ait) mes- 
sage follows the call but no r(eady) message 
is given until output is reattached to console. 

iocall attach user_output syn user_i/o 

reattaches output to the console, r(eady) mes- 
sage follows. 

iocall detach zz 

User detaches zz after reattaching output. 
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LINK 
Format : 
Purpose: 




Examp les: 



COMMANDS 

Reference: BX.B, 04- 

link patht path 2 

To create a link to the entry 
specified by patht from the entry 
specified by path 2 . 

patht must include the directory 
as well as entry to enable the 
link to be made. 

path 2 may be absent. In that case 
a link is created in the user's 
working directory having the same 
entry name as that given in patht 

link > 1 i brary>i saac 

makes a link entry "isaac" in the 
working directory. 

link >user_di r d i r>i saac >mydir>= 

makes link entry "isaac” in "mydir". 

link ([files >user_di r d i r>joe>" :s "*]) 

creates for each entry in the 

directory >user_di r d i r>joe a link 

entry of the same name in the 
working directory. 
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COMMANDS 


LIST 


Reference: BX.8.01 


Format : 


list path ioname option 


Purpose : 


To print out a list of entry names or a 
subset of the entry names in the direc- 
tory piven bv path. 


t 


ioname is an optional name of an at- 
tached stream to which output is direc- 
ted. Default is user_output. When 
ioname is given, diagnostics are given 
on both ioname_output and user_output. 




If option is not present, both branches 
and links will be printed. The possible 
options are: 




b - print branches only 
1 - print 1 inks only 




If an option is present in the command 
and no ioname is to be attached, a null 
strinp. ,t,! • must be piven for ioname. 


Notes : 


* and ** conventions may be used. 


Example: 


1 i st sy sternal i brary>alpha. ** 

produces a list of branches and links 
that might be: 

Branches 




alpha 

alpha . 1 ink 
alpha. symbol 


• 


Links 


w 


alpha, new >system_l i brary_ 3 _ beta 
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LI ST ACL 
Format : 
Purpose: 



t 

Notes: 



Examp le: 
Restrict 



COMMANDS 

Ref erence: BX. 8.03 

listacl path acnamel . . . acnamen 

To print access control information on the 
entry name specified by path and users 
specified by acnames . If path terminates 
in >, information is printed from the 
directory ! s CACL; otherwise information is 
printed from the ACL of the entry name. 
acname has the form: 

personal_name.project_i d. tag 
as in: Brown. Mu It i cs. qv 

listacl !MT acnames prints the CACL of 
the working directory relating to acnames . 

listacl path ** prints access control in- 
formation on all users of path . 

If P a th specifies a directory or a branch in 
a directory, the user must have the read 
attribute on in the directory or branch. If 
path specifies a link, the user must have the 
read attribute on in the entry to which the 
link eventually points and must also have the 
execute attribute on in the directory con- 
taining the link and all intermediate direc- 
tories linking to the ultimate entry. 

listacl >my_d i r> Smith. Mult ics.* 

prints the CACL of my_dir for 
acname, Smith. Mu It ics.* 

ion: Because listacl has not yet been imple- 
mented as described above, use the 
following format to list ACL information 
from the CACL of a directory: 

change_wd i r >some_d i r 
listacl 11,1 acnamel ... acnamen 
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LOGIN 



Format : 



Purpose: 

t 



Examp le: 



COMMANDS 

Reference: BX.3 • 01 
not yet published 

login username project^ d 

To gain access to Multics at 
command level after dialing into 
the system. 

username is the name of a user 
acceptable to Multics. 

projected is the identification 
of the group with which the user 
is associated, Multics. 

login Smith Multics 
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COMMANDS 

LOGOUT Reference: BX.3.04 

Format: logout 

Purpose: To end communication with the 

Multics system, thus termin- 

ating a console session. 

Example: logout 

W 930:15.7 

Smith jVlultics logged out 

The system responds to a logout 
with a W(ait) followed by the 
time of day to the tenth of a 
■second. The system then indi- 
cates the logout is complete; 
the user's connection to the 
computer is broken and he must 
dial up and login in order to 
restore communication. 
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COMMANDS 



MERGE EDIT 






Reference: BE. 18.00 

BE. 18.01 



Format: merge_edit g_path runname username options 



Purpose: To create an I MCV tape on Multics that can 

be run under GECOS, performing assemblies, 
etc., and producing a tape by which results 
can be returned to Multics. (See tape_in 
for returning results.) 

g_path specifies the entry name of a 
me r g e _edit control segment used to select 
text for the IMCV. (See merge-edit con- 
trol lines section.) The second component 
of the g_path entry name, if given, must 
be . gecos. 

runname is a 1 to 6 character primary com- 
ponent of the job name assigned the two 
tape_daem° n control segments merge_edit 
creates in the wdir as intermediate output, 
i.e., a runname . jobx, creates two tape_ 
daemon segments: jobx. control and 

jobx. control. binary. 

username is a 1 to 12 character user name. 
options Two can be specified: 

notape /* do not signal tape_daemon*/ 

\ /* Run tape at Murray Hill or MAC*/ 
mac f 



Notes: To notify tape_daemon to execute control 

segments produced by a previous merge_edit 
the command is: 

m er g e _edit runname (tape) 

where runname is that used in the previous 
command and (tape) is a literal 

Example: merge_edit comp2. gecos job2 Bennett mac 
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MOVEBRANCH 



COMMANDS 

Reference: BX. 8.12 



Format : 
Purpose: 



Notes : 



Examples : 



movebranch pathl path2 

To move a non-di rectory branch from 
one directory to another, deleting 
the original branch given by the entry 
name, pathl . (and the associated ACL) 
and establishing the new branch with 
the same entry name or a new entry 
name, given by path2 (with the 
associated ACL). 

Read and write modes are required in 
the branch to be moved. Write and 
execute modes are required in the 
directory of the branch to be moved. 

Write and append modes are required in 
the directory of the entry to be 
created. 

If path2 already exists, no move is done. 

A directory with inferior segments may 
not be moved. 

The = convention may be used. 

movebranch >ol d_d i r>f red. 1 i nk joe.= 

The branch TT f red. link 11 in directory 
M >old_dir M is moved to the working 
directory and given the name 11 joe. 1 ink 11 . 
The entry M fred.link M in M old_dir !f no 
longer exists. 




movebranch joe. link >old_dir>= 

The branch n joe.link fl in the working 
directory, is moved to the directory 
n old dir n . 
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COMMANDS 



Reference: BX.99.05 



mspeek path offsetl offset2 

To write onto the output stream, 
user_output, the octal representation 
of a selected part of a segment, given 
by path. offsetl and offset2 are 
character strings representing the 
starting and ending octal locations for 
the dump. 

mspeek my_seg 27 77 
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NEW_PROC 
Format : 
Purpose: 



t 

Notes: 



Examp le: 



COMMANDS 



new_proc 

Creates a new process and leaves the 
user in the working directory he was 
in when he logged in. The old pro- 
cess is available for ^debugging but 
not for further processing. 

At present, newjoroc causes the 
system to hang up the user. 

When he redials he will be in the 
new process. 

Assuming a quit has been made: 
new_proc 

creates a new process, leaving 
the user in his previous working 
directory. 
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COMMANDS 

NOTH1 NG Reference BX.20.04 

Format: nothing 

Purpose: To provide a return giving 

minimal return time, thus 
aiding the interpretation of 
time needed to execute other 
commands. 
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COMMANDS 



Reference BX.9.02 

print pat h 1 ineno end 1 ineno 

To cause an ASCII text segment of 
entry name path , starting with the 
segment line specified by 1 ineno 
and ending with the segment line 
specified by endl ineno to be writ- 
ten in the user’s output stream 
”user_output” . 

where : 

path is the entry or path name of 
the segment to be printed. 

1 ineno is an optional argument 
specifying the line number of the 
first line to be printed. If null, i.e, 
omitted or replaced with tM! (2 double 
quotes with no space) or s ' (balanced 
left and right accents with no space 
between them), in which case, the 
entire segment is printed, with a 
short identifying header. Must be 
used when endl ineno is used. 

( L ineno may be a null string as 
above, or 0 or 1, or may be left off 
entirely if endl ineno is also omitted.) 

endl ineno is an optional line number 
of the last line to be printed; may be 
omitted or replaced with ”” (2 double 
quotes with no space) or w (left and 
right accents with no space between 
them), in which case the segment is 
printed from 1 i neno to its end. 

Assumes that new 1 ine characters are 
appropr iately embedded in the text. 

print my_seg2 7 9 

print my_seg3 
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COMMANDS 



PRINTJDBRS Reference BX.99.03 



Format: print_dbrs 

Purpose: To print out the values of 

the ring 0, 1, and 32 DBR 
settings of a single process, 
so that dumps of the process 
may be easily taken. 

Notes: Currently this command is called 

automatically at process 
initialization. 
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COMMANDS 

PR I NT L I NK_ I NFO Reference: BX.9.05,BX.9.05A 





Format: pr i n t 1 ink_info path file 

Purpose: To print linkage block information for entry 

patn . Information includes: 

1) text segment length. 

2) <segment>l [symbo 1 ] names for each link pair, 

3) list of entry point and segment definition 
names, giving ASCII representation, octal 
value and symbol class. 

4) link pair list giving: 

a. address relative to linkage segment base 

b. <segment> I [symbol] to which a link 
points or self-reference. 

c. call pointer and argument pointer of 
trap word if it exists. 

Presence of the optional literal file as a 
second argument causes the contents to be 
placed in a segment, path . prink 



Example: pr i n t 1 ink_info ps 

Segment >user_dir_dir>Garman.Multics ps 
Text segment length (in octal) 

Linkage block number 1 
Entry points and segdef names 
rs 32 entry point 

ps 24 entry point 

symbo l_table 



rel_text 
rel_l ink 
rel_symbol 

Link pairs 

10 

12 

14 

16 

20 

22 

40 



30 

56 

64 



symbo 1 
symbo 1 
symbol 



.argcount ] 
cxcj 
te] 



< ar g_ c °unt> I 
<cv_str ing> I 
<wr i t e> I [wri 
<read> I [read] 
<command_arg> I [return] 
next 10,7 
<1 i b > I [ 1 ib_] 
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PROBE 
Format : 
Purpose: 

t 

Notes: 



Example: 






COMMANDS 

Reference: BX. 10. 00 A 

probe 

To allow the user to enter the 
debugging system and issue a 
series of requests for debugging 
information. The command can be 
issued at an interruption of a 
command or at normal termination 
of a command. Probe requests 
produce information on one or 
more segments of the process. 

See section on probe requests for 
information that can be obtained. 

If a request issued after a probe 
command is not recognizable as a 
request, it is treated as a command. 

probe 

w 924*09. 8 

System responds to probe command with 
a W(ait) followed by a hyphen. User 
types in the probe request immediate- 
ly following the hyphen. System will 
print out the requested information 
and then issue another ready-for-re- 
quest (hyphen). User terminates probe 
with a quit request. 




111-50 Rev 2 06019 



0DUMP7 
Format : 
Purpose: 




otes: 



Examp le: 



COMMANDS 

Reference: BX. 99. 11 

qdump7 pat hi path2 . . . pat hn 

To cause the segments given by 
pat hi to pathn to be converted 
to 7-punch format and queued for de- 
layed punching by the output driver 
daemon. 

If :a segment is missing or has a 
current length of zero, the segment 
is skipped. 

qdump7 >u ser_d i r _d i rXJay . Mu 1 1 i cs>comp 

causes segment, comp, from the 
directory given in the path to be 
queued for punching in 7-punch 
format. 





111-51 Rev 2 06019 




COMMANDS 



QED 

Format : 
Purpose: 




Reference: BX.9.06 

qed input_file output_file 

To create or to edit a text file using the 
QED editor. 

input_file is the input stream to QED and 
may be an entry name in the working direc- 
tory, a pathname to an entry in another 
directory, or can represent console input. 



output_file is the output stream from QED 
and may be an entry name in the working 
directory, a pathname to an entry in 
another directory, or can be output to the 
console. 

Notes: If end-of-file is reached on an input file, 

input switches to the console. 

See. sect ion on QED requests for editing 
requests that can be used once QED is en- 
tered. 

Examples: qed 

Input and output are from and to the console, 
qed my_f ile.bcpl 

Input is taken from my_f ile.bcpl in the user's 
wdir and output is to the console. 




qed >joes_dir>epl3 my_file.epl 

Input is taken from epl3 in another user's 
working directory and output is to my_file.epl 
in the wdir. 

qed - my_eplbsa3.eplbsa 

Input is taken from the console and output 
is to my_eplbsa3 .eplbsa in the wdir. 
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READ7 

Format: 



Purpose: 

Notes: 



Examp le: 



COMMANDS 

Ref erence: BX.99. 09 



read7 

read7 rename 

To read 7-punch card decks from a 
directly attached card reader into 
a segment with any valid pathname. 

The pathname of the segment is 
given on the header card of the 
deck. 

If the literal, rename, is given as 
an argument to read7, the user is 
requested to give the new pathname 
from the console. If a pathname 
given on the header card is not 
found, the user is requested to give 
a new pathname from the console. 

Bee reference MSPM section for 
formatting of the input deck. 

read7 

If it is not possible to attach the 
card reader, read7 issues a comment 
at the console. Otherwise, read7 
attaches a card reader on channel 
n rdrb38 !f and begins accepting 
card input. 
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REMOVE 

Format : 
Purpose : 



Notes : 



COMMANDS 

Reference: BX.8.07 

remove path 

To remove a branch from the file system, 
where path terminates in the entry name 
of a branch. 

Write mode is necessary in the branch 
to be deleted and its directory. 



Remove refuses to remove a directory 
subtree (remove_dir must be used) or 
an entry pointed to by a link. 

Examples: remove segl 

The branch segl is removed. 
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COMMANDS 

REMOVE J) I R 

Format: remove_dir path 

Purpose: To remove the directory specified by 

path and all segments inferior to it. 

Notes: Write mode is necessary for every 

branch to be removed and for the 
directory containing each branch. 

Example: remove_dir my_dir1 

The directory my_dir1 in the working 
directory and all segments inferior 
to it are removed. 
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RENAME 
Format : 
Purpose: 




Notes: 



Examples: 



COMMANDS 

Reference: BX.8.08 

rename path entry 

To change the entry name specified 
by path to the name specified by 
entry . 

Write attribute must be on in user's 
working directory. Read attribute 
must also be on if the * convention 
is used. Both * and = conventions 
may be used in rename. 

rename >user_di r d i r>fred george 

where the result is renamed 
>user_di r d i r>george 

rename ([files *.epl]) =.pl1 

all two-component names with second 
component "epl" in the working direc- 
tory are changed to have a second 
component "pll". 
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RUNCOM 
Format : 
Purpose: 



t 

Notes : 



Example: 



COMMANDS 



runcom path arg l ... ar gn 

To permit the user's next input lines 
to be taken from the ascii text seg- 
ment, specified by path , rather than 
from the console, argl ... argn are 
optional arguments to be inserted into 
the text of path. 

Each argument is inserted into the text 
of path as indicated by the include (&) 
sign, followed by a decimal number, 
where: 

is the first argument, 

&2 is the second argument, etc. 

runcom >my_l ib>sub_loop f red george 



Assume the contents of sub__loop are: 

rename >my_lib>&1 &Z 

Then the input r rom sub_loop is: 

rename >my_lib>fred george 

causing entry name george to replace 
entry name f red in the directory 
my_l ib. 
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COMMANDS 



SET ACL Reference: BX.8.02 

Format: setae 1 path mode acnamel ... acnamen 

Purpose: To modify access to the entry name specified 
by path for users specified Dy acnamel to 
acnamen . The new mode is given by mode and 
may be any combination of letters rewa (Read, 
Execute, Write Append), acname has the form: 

personal jname. pro ject_i d. tag where : 

personal_name is a user name, e.g., Smith, 
projected is Multics, and 
tag is an instance tage identifying the 
process-group in which the user is working. 

* (any instance tag) can be used. 

Notes: setae 1 path !Mt acnamel ... acnamen 

causes listed acnames to have no access to 
path . 

setae 1 path mode 

assumes acname is the personal_name of the 
invoking user and that tag is *. 

If path specifies a directory or branch in a 
directory, the user must have read, write and 
execute attributes on in the directory. If 
the user attempts to modify an ACL, given a 
link to it, the user must have, besides the 
access above, the execute attribute on in the 
directory containing the link and all inter- 
mediate directories leading to the branch. 

Example: setacl my_dir>alpha re Smith. Multics.* 

gives read and execute access to alpha in 
my_dir to Smith. 

• Restriction: Because setacl has not yet been imple- 

mented as described above, use the following 
format to set access in the CAGE of directory 
some_dir: 

change_wdir >some_dir 

setacl !!!! mode acnamel ... acnamen 
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START 
Format : 
Purpose: 



Examp le: 

f 



COMMANDS 

start 

To resume processing in the same 
process after a quit and at the 
point at which the quit was issued. 

User is in QED building an EPL 
program. 

User hits ATTENTION button on 2741 
once. 

quit 

r 1:11.2 25.3 53 /* system response*/ 

start /*User is now in Q.ED at the 
point at which he issued the 
quit and can resume building 
the EPL program.*/ 
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STATUS 



Format: 
Purpose : 

Examples: 



COMMANDS 

Reference: BX.8.01 

status path 

To print detailed file status 
information on the branch or link 
specified by path . 

status comp. err 

branch :>user_di r_dir _>Doe.Multics>comp.err 

unique id: BBDHq jggWWFZMh 

date used: 09/07/68 1424.4 EST Sat 

date modified: 09/07/68 1351.2 EST Sat 

branch modified: 09/07/68 1351.2 EST Sat 

mode: read 

bit length: 24192 

current blocks: 1 

maximum blocks: 23 

ring brackets: 32 32 32 

status lkx 

link: >user_di r d i r> South .Mult i cs> lkx 

links to: >system_l i brary>new_l i nk 

date link used: 09/07/68 1426.4 EST Sat 

date link modified: 09/07/68 1426.4 

EST Sat 
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COMMANDS 

TAPE_IN Reference: BX.99.02 

Format: tape_in reel_no segmental ist 

Purpose: To input into the user ! s working 

directory the segments, given in 
segmental ist , which are taken from the 
CTSS 7-punch format tape whose reel 
number is given by reel_no . 

segmental i st is a list of CTSS segment 
name pairs, written in small letters, 
or the list may be designated as all. 
If all is given, all segments on the 
specified tape are input. 




Notes: If the segments to be input were placed 

on the CTSS 7-punch tape using the 
tape_out command, differences in the 
Multics and CTSS naming conventions 
may have affected the names of the 
segments. See tape_out command. 

Examples: tape_in 144 all 

tape_in 201 epla text epla link eplb text 
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TAPE_OUT 
Format : 
Purpose: 

t 



Notes: 



Example: 

t 



COMMANDS 

Reference: BX.99.01 

tape_out reel_no path_l i st 

To write a tape containing segments from the 
Multics file system hierarchy onto a tape in 
CTSS disk editor (7-punch) format, where: 

reel_no is a tape identifier (name or number 

of the tape to be written), scr is used to 
designate any scratch tape. 

path_l ist is a list of entry names of seg- 
ments to be written onto the tape. If the 
literal all is used in place of path_l ist, 
all segments in the working directory are 
written. 

If reel_no is given without a path_l ist , a 
check is made to see if the control file 
with that identifier exists. If so, the ex- 
isting control file is used to write a tape. 

By CTSS/GECOS convention, all segment names 
have two components, each of which is 6 
characters or less. A single-component 
name taken from Multics will be given a sec- 
ond component, TEXT. A Multics name having 
more than 6 characters in a given component 
is truncated to 6 characters, which are the 
first three and last three of the original 
name. 

tape_out 25 alpha. epl beta epsilon 
epsi Ion. 1 ink 

The command produces on tape 25 four seg- 
ments taken from the user's working di- 
rectory and having the names: 

ALPHA EPL 
BETA TEXT 
EPSLON TEXT 
EPSLON LINK 
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COMMANDS 

TIME Reference: BX.20.02 

Format : time 

Purpose: To print out five times a repre- 

sentation of current time in octal, 
followed by that time converted 
into ascii representation. 

Example: time 

Output: 000000074423461650075004 

30 Jun 1500.47 EDT Sun 1968 
15:00:29.019652 
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COMMANDS 



UNLINK 


Reference: BX.8.05 


Format : 


unlink path 


Purpose: 


To delete the link entry speci- 
fied by path. 


Notes: 


Write attribute must be on for 
the directory containing the 
link. 


Examp les: 


unlink fred__link 




where fred_link is a link entry 
deleted from the user T s working 
directory. 




unlink ( [f i les **]) 




all links in the working directory 
are deleted and error messages are 
printed for non-link entries. 




111-63 Rev 2 06019 




COMMANDS 




WHO 

Format : 
Purpose : 



Examples : 



Reference: MCB-275 

who username - ! . . . usernamen 

To determine what users are logged 
into Multics. 

If usernames are given as arguments, 
Multics will indicate whether or not 
those users are logged in. 

who 

a list of all current users will be 
printed out. 



who Meer Shih Spier 

an indication of whether one or more 
of the listed users is logged in will 
be printed out. 
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MERGE EDIT CONTROL LINES 




bcpl 

core 

deck 

entry 

epl 

ep lbsa 
error 
f etch 
insert 
li be 
load 
maket 1 
notape 
pure 
symbo 1 
text+link 
tmgl 
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BCPL 



M er ge_edi t Control Segment Lines 



Format : 



Purpose: 
Def ault : 



Example of 
li ne: 



Merge-edi t 
I MCV tape: 



bcp 1 di r>sourcesegment 

be di r>sourcesegment 

To identify a bcpl sourcesegment 
for compilation by BCPL. 

If di r is null, sourcesegment 
is assumed to reside in the 
user’s working directory. 

control segment containing bcpl control 

bep 1 q_0 

load q_0 

fetch q_0 * 

command to place bcpl program q-0 on 




merge-edit q.jO exl shore mac 
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Merge_ e dit Control Segment Lines 

CORE 

Format: core 

Purpose: To obtain on-line dump of segments 

having either the data option or 
wpermt option. 

Note: See pure control line for dumping 

of all segments. 

Example: bcpl q-0 

load q-0 wpermt 

core 

f et ch q-0 * 
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DECK 
Format : 
Purpose: 



Def ault : 
Example: 



Commands: 



Merge_edit Control Segment Lines 



deck segnamel . . . segnamen 

To obtain punched decks of 

object code resulting from 

BCPL, EPL, EPLBSA, or TMGL activities or 

maketl and text+link inclusions 

conducted on segnamel to 

segnamen . 

If one of the segnaroe i is *, 
all object code generated 
from source segments in a 
given run will be punched. 

bcp 1 q-0 

bcp 1 xjO 

load q-0 

load x-jO 

fetch q-0 # x_0 * 

deck q-0 



merge_edit q-0 exl stone mac notape 
merg e _edit n-0 ex2 stone mac 
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Merge_edit Control Segment Lines 



ENTRY 
Format : 
Purpose: 



Def ault : 



Notes : 



Examp le: 



entry segmentname entryname 

To specify an entry point for 
the start of execution of the pseudo- 
process. Segmentname is the name of 
an external segment and entryname 
is the entry point within 
segmentname . 

If entryname is null, entryname 
is presumed to be the same as 
segmentname . 

segmentname entryname in merge__edit 
control line is equivalent to 
segmentnamefentryname in EPL and 
to <segmentname> I [entryname] in 
EPLBSA. 

epl syzygy 

entry syzygy sunspot 



load syzygy 
fetch syzygy * 
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Merge edit Control Lines 



EPL 

Format : 



Purpose: 
Default : 

Examp le: 



ep 1 di rectory>sourcesepment 
e di rectory>source segment 
ep 1 sourcesepment 
e sourcesepment 

To identify a sourcesegment to 
be compiled by EPL. 

If di rectory is null, 
sourcesegment is assumed to 
reside in the user's working 
d i rectory. 

e P 1 syzygy 

load syzygy 

fetch syzygy * 
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M er g e _ e di t Control Segment Lines 



t 



EPLBSA 
Format : 



Purpose: 
Def ault : 

Example: 



eplbsa di recto ry>sourcesegment 

eb di rectory>sour cesegment 

eplbsa sourcesegment 

e b sourcesegment 

To identify a sourcesegment to 
be assembled using EPLBSA. 

If di rectory is null, 
sourcesegment is assumed to be 
in the user ! s working directory. 

eplbsa quirk 
load quirk 
fetch * * 
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ERROR 
Format : 
Purpose: 

Note: 
Examp le: 



Merge_edit Control Segment Lines 



error 

To cause the error segment to 
be printed on the on-line output. 

An error segment is automatically 
returned to the user if a fetch 
control line is in effect. 




eplbsa quirk 
load quirk 
deck * 
error 
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M er ge_edit Control Segment Lines 



FETCH 



Format: fetch segl desc l ... segn descn 

Purpose: Fetches (returns) object (assembled) 

segments, placing entries for them 
in the user’s working directory. 

segi is the first component of a 
source segment name (CTSS namel) 
to be put in the working directory. 
If segi is *, all segments produced 
by compiler and assembler activities 
are fetched. 

desci is any character string or #, 
If text, link, symbol, and list 
segments are fetched. If desci is 
any other string, no list segment 
is returned. 

Note: If desci of the last segment is 

blank, text, link, and symbol 
segments are returned. 



Examples: EXAMPLE 1 

epi syzygy 
eplbsa quirk 
load syzygy 
load quirk 



EXAMPLE2 
epl syzygy 
eplbsa quirk 
load syzygy 
load quirk 



fetch syzygy m quirk * fetch * 

In example"!, working directory entries 
are made for syzygy and qui rk withtext, 
link and symbol segments returned for 
each. A list segment is also returned 
for quirk. 

In example2, working directory entries 
are made and text, link, and symbol 
segments returned for syzygy and quirk. 
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Me r g e _ e dit Control Segment Lines 

I NSERT 

Format: insert di r>name_gecos 

Purpose: To insert a previously created 

merg e _edit control segment, 
name_gecos, in the current 
control segment. 

When an insert line is encountered, 
control lines are read from 
name_gecos. When the final 
name_gecos line is read, control 

lines are again read from the 
current control segment. 

Notes: If di r > is null, name g ecos is 

assumed to be in the working 
directory. Nesting of insert 
lines is permitted to a depth 
of 9. 

Example: Control segment syzygy_gecos contains: 

epl syzygy 
load syzygy 
fetch syzygy 

This sequence of control lines: 

bcp 1 q_0 
load q 0 

insert syzygy_gecos 
f et ch q_0 

produces the following sequence of 
merge_edit control lines: 

bcpl q_0 
load q_0 
epi syzygy 
load syzygy 
fetch syzygy 
fetch q_0 
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Mei-ge_edit Control Segment Lines 




LIBE 



Format: libe segname options 
1 i segname opt ions 



Purpose: To load 
file. 


a segment directly f rom a 


1 ibrary 


Opt ions : Opt ion 


Meaning 


Bit; 


fO 


Directed fault 0 


00 


fl 

• 

• 


Directed fault 1 

• 


10 

• 


f7 


• . 

Directed fault 7 


• 

70 


data 


Data segment 


01 


slvprc 


Slave procedure 


02 


exonly 


Execute only 


03 


masprc 


Master procedure 


04 


slvacc 


Slave access 


20 


wpermt 


Write permit 


40 



Segment descriptor bits are taken as the in- 
clusive OR of option bits. A descriptor con- 
taining fault 2 is created for a segment 
given slvacc . Options slvacc and wpermt are 
used only with other options, as in: 

Control Line Bits 

libe progl slvacc, slvprc, wpermt 62 

Initial default option values are slvacc . 
slvprc . If a control line is encountered 
having other options, previous option values 
are cleared. The new values become default 
values for subsequent lines until changed. 

Notes: Segments called off library automatically, 

not requiring libe control lines: 



escape free_page_pool f2catc 

get_put grow in it 

length 1 ibrary_dict ionary linker 

messag newpag newseg 

relpag search segman 

segpr_ tracer database trunct 

Example: eplbsa quirk 
load quirk 
li bin_oct 
fetch * * 
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LOAD 
Format : 



Merge edit Control Segment Lines 



Purpose: 



Default: 



Options: 
Example : 



Id sourcesegment opt ions 

To cause the loading and execution 
of segments produced by BCPL, 

TMGL, EPL or EPLBSA activity. 

An asterisk (#) for source - 
se gment causes all text, link, 
and symbol segments produced BCPL, 
TMGL and EPL compilations and 
EPLBSA assemblies in the same run to 
be loaded. 

If opt ions are null, options 
specified by the last load, 
libe, text+link, or maketl 
control line remain in effect. 

If no options were previously 
specified, default options are 
slvprc slvacc. 

Options are given under libe 
control line. 

epl syzgy 
eplbsa quirk 
1 oad * 

fetch * * 
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Mei'ge_edit Control Segment Lines 



MAKETL 
Format : 

Purpose: 
Def au It : 



Note: 

Options: 
Examp le: 

i 



maketl di r>entryname : segname opt i ons 

mk di r>entryname : segname options 

To cause a previously assembled 
text segment, entryname . in direc- 
tory, dir, to be loaded as segment 
segname. for execution. A dummy 
linkage segment is also loaded. 

If dir is null, the user's working 
directory is presumed. 

If segname is null, the text segment 
i s loaded as entryname . 

If options are null, options speci- 
fied by the last load, libe, 
text+link, or maketl control line 
remain in effect. If no options 
were previously specified, the 
default options are slvprc slvacc. 

If di r>entrvname is *, a dummy 
text segment is loaded. 

Control line, text+link, loads a 
text segment with its actual linkage 
segment . 

Options are given under libe control 
line. 

maketl spasm 
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NOTAPE 
Format : 
Purpose 

Notes: 



Example 



Merge_edit Control Segment Lines 



notape 

To suppress the creation of a return 
tape by GECOS, overriding a fetch control 
line. 

This control line differs from the 
notape argument in the merge_edit 
command. The argument prohibits 
Mult i cs from making an IMCV for input 
to GECOS: the control line causes GECOS 
to suppress creation of a return tape. 



ep 1 syzygy 
load syzygy 
deck * 
notape 
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Merge_edit Control Segment Lines 

PURE 

Format : pure 

Purpose: To obtain on-line dump of 

all segments if a core control line 
is also included. 

See core control line for 
on-line dump of data and 
write-permit segments only. 

Examples: epl s Y z ygy 
load syzygy 
pure 
core 
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M er g e _ e dit Control Segment Lines 



SYMBOL 
Format : 
Purpose : 



Note : 
Example : 



symbol 

To cause the symbol segment 
of all segment groups named in 
text+link control lines to be 
loaded. If this line is. absent, 
only text and link segments will be 
loaded . 

See text+link control line. 

tl spasm 

symbol 
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Merge_edit Control Segment Lines 
TEXT+L INK 

Format: text+link d i r>entryname r segname options 

tl d i r>ent r yname : segname opt ions 
tl d i r>entryname options 

Purpose: To cause a previously assembled 

text segment, entr yname , in directory, 
dir , to be loaded as segment, 
segname , for execution. The 
associated linkage segment is also 
loaded. 

Default: If di r is null, the user T s working 

directory is presumed. 

If segname is null, the text segment 
is loaded as entryname . 

If options are null, options specified 
by the last load, libe, text+link, 
or maketl line remain in effect. 

If no options were previously 
specified, default options are 
slvprc slvacc. 



If d i r>entr yname is *, a dummy text 
segment is loaded. 

Options: Options are given under libe control 

line. 

Note: Control line, maketl, loads a text 

segment and a dummy linkage segment. 

Example: tl spasm 
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TMGL 

Format: 

Purpose: 



lerge_edit Control Segment Lines 

tmgl dir>sourcesegment 

To identify a sourcesegment 
for compilation by TMGL. 

Default: If dir is null, sourcesegment 

is assumed to be in the user’s 
working directory. 

Example: tmgl scan 

load scan 
fetch scan * 
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EDM Requests 



BACKUP : 


- 


Format : 


-n 


Purpose: 


Move pointer back up the seg- 
ment the number of lines 
specified by the integer n. 


Spaci ng: 


A blank is optional between 
the request and the integer 
argument. 


Default: 


If n is null, the pointer 
is moved up one line. 


Example: 


Bef ore : 


a: procedurej 
x = y; 

q = rj 
s = tj 
-> end a; 


Request: 


-2 


After: 


a: procedure; 

x = y; 

-> q = rj 

S = t; 
end a; 
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BOTTOM : 
Format : 
Purpose: 

Pointer : 
Examp le: 
Before: 

Request : 
Af ter : 



EDM Requests 

b 

b 

Move pointer to end of segment 
and switch to EDM input mode. 

Set after last line in file. 




a: procedure; 

x = y; 

-> q = r; 
s = t; 

end a; 



b 



a: procedure; 

x = y; 

q = r; 
s — t ; 
end a; 
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EDM Requests 



CHANGE: 
Format : 
Purpose: 



t 

Del imiters: 



Default : 



c 

cn /str inpl/str inp2/ 

Replace str ingl by str irnp2 in the 
number of lines indicated by integer n. 
EDM responds to each change by printing 
the line with the changed text in red 
if the user is in VERBOSE mode. 

Any character not appearing in str ingl 
or str ing2 can delimit the strings 
(/ is shown in the format). Delimiter 
following str ing2 is optional. A 
space before n and between n and the 
str ingl delimiter is-'opt ional . 

If integer is absent, only str inpl 
of the current line is changed. 



If str inpl is absent, str ing2 
is inserted at beginning of line. 

Pointer: Set to last line changed. 

Example: 

Before: -> a: procedure; 

x = y. 
q = r. 

s = t; 
end a; 

Request : c2/ ./ ; 




Response: x ~ y; 

q = rj 

After: a: procedure; 

x = y; 
q = r; 
s - t; 
end a; 
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DELETE d 

Format: d n 

Purpose: Causes the number of lines 

given by the integer n to 
be deleted. Deletion begins 
at the current line. 

Spacing: A space is optional between d and 

the integer. 

Default: If n is null, the current line 

is deleted. 

Pointer: Set to first line following the 

lines deleted. 

Examp le: 

Before: a: procedure; 

-> x = y; 

q = r; 

s = t; 

end a; 

Request: d 2 

After: a: procedure: 

-> s = t; 

end a; 
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EDM Requests 

FIND f 
Format: f str ing 





Purpose: 



Spac i ng : 



Default : 



Pointer : 



Search segment for line beginning with 
string . Search starts at line following 
the current line and continues around the 
entire segment until string is found or 
until return to current line. The current 
line is not searched. 

If line is not found, an error message, NO, 
is printed in red. If the line is found 
and user is in VERBOSE mode, the line is 
printed. 

A single blank following f is not signi- 
ficant; all other leading and embedded 
blanks are used in searching. 

If string is null, EDM searches for the 
string requested by the last f or 1 
request. 

Set to line found or remains at current 
line if the line is not found. 



Example: 

Before: 



4, (first character position) 
a: procedure; 

-> x = y; 
s = t; 
end a; 



Request : f t 



(note blanks for character 
positions) 



Response: 
Request : 
Response : 
Af ter : 

-> 



NO 

f s 

s — t ; (VERBOSE mode) 

a: procedure; 
x = y; 
s = t; 
end a; 
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INSERT : 
Format : 
Purpose: 

Spaci ng: 

Def au It : 

Pointer : 
Note: 

Example: 
Before : 



Request: 
After : 



EDM Requests 



i newline 

Insert newline after the cur- 
rent line. 

First blank following _i_ is not 
significant. All other leading 
and embedded blanks become 
part of the text of the new 
line. 

If newline is null, blank line 
is inserted. 

Set to the inserted line. 

Immediately after a t (TOP) 
request, an i request causes 
the newline to be inserted 
at the beginning of the segment. 

jp, (first character position) 
a: procedure; 

x = yj 

q = r; 

-> s = t; 

i end a; 

a: procedure; 
x = y; 
q = r; 

s = t; 

■> end a; 
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EDM REQUESTS 
KILL : k 

Format: k 

Purpose: To inhibit EDM from printing 

out responses following an f, 1, 
or c request. The EDM system 
default is VERBOSE mode. 

Pointer: Unchanged. 

Note: See v (VERBOSE) request. 

Example : 

Request: v 

c /y/z 

Response: y ~ z; 

Request: k 

c /z/y 

No response 
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LOCATE : 
Format : 
Purpose: 



Spaci ng: 



Default: 



Pointer : 



Example: 
Before ; 



Request! 
After : 



EDM Requests 



1 

1 string 

Search segment for line containing 
string. Search starts at line fol- 
lowing current line and continues 
around entire segment until string 
is found or until return to current 
line. If the line is not found, an 
error message NO is printed out in 
red. If line is found and user is 
in VERBOSE mode, the line is printed. 

Single blank following 1 is 
not significant. All other 
leading and embedded blanks 
are used in searching. 

If string is null, EDM 
searches for the string re- 
quested by the last 1 or f 
request. 

Set to line found or remains 
at current line if line not 
found. 




a: procedure} 

x = y; 

q = rj 

-> s = tj 

end a; 

1 x = 

a: procedure; 
-> x = y; 

q = r; 

s = t; 

end a; 
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EDM Reauests 


NEXT: 


n 


Format : 


n n 



Purpose: 


Move pointer down the segment 
the number of lines speci- 
fied by the integer n. 


Spaci ng: 


Blank optional between n 
and the integer. 


Default: 


If integer n is null, the 
pointer is moved down one 
line. 


Example: 


Bef ore : 


a: procedure? 
x = y? 

-> q = r? 

s — t ? 
end a; 


Request: 


n 


After: 


a: procedure; 

x = yj 

q = r; 

-> s = t; 

end a; 
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PRINT ; 
Format : 
Purpose: 

Spaci ng: 

Def au It : 

Pointer : 
Examp le: 

Bef ore : 

Request: 

Response: 

After: 



EDM Requests 
P 

pn 

The number of lines specified 
by the integer n will be 
printed out beginning with 
the current line. 

A blank is optional between 
p and the integer. 

If n. is null, the current 
line is printed. 

Set to last line printed. 



a: procedure; 
x = y; 

-> q = r; 
s = t; 
end a; 

P 3 

P = r; 
s = t; 

end a; 

a: procedure; 
x = y; 

q = r ; 

s = t; 

-> end a; 
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QUIT : 
Format : 
Purpose: 

Note: 

Example: 
Oldfi le: 



Request : 

Response: 
Request: 
Newf i le: 



EDM Requests 

q 

q 

Terminate EDM editing without 
saving the edited copy of the 
segment. 

To save segment, see s (SAVE) 
request. 



a: procedure; 
x = y; 
q = r; 
s = t; 
end a; 

c /$/ (y»0 j/ 

P 



a: procedure (y, r) ; 



q 



a: procedure; 
x = y; 
q = r > 

s = t; 
end a; 






Original 
(uned i ted) 
file is 
retained. 
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RETYPE ; 
Format : 
Purpose: 

Spaci ng: 

Default: 

Poi nter : 
Examp le: 
Bef ore : 

Request: 
After : 



EDM Requests 
r 

r newli ne 

Replace current line with 
newli ne . 

One blank between r and 
newline is not significant. 

All other leading and embed- 
ded blanks become part of 
the text of the new line. 

If newli ne is null, a blank 
line replaces the current line. 

Unchanged. 



a: procedure; 

-> x = y; 

q = rj 
s = tj 

end a; 

r del (r,t) float bin (27); 
a: procedure; 

•> del (r,t) float bin (27); 

q = r; 

s = t; 
end a; 
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SAVE : 
Format : 
Purpose : 




Spacing: 

Default: 



Note : 

Example : 
Oldf i le : 




Requests: 
Newf i le : 



EDM REQUESTS 
s 

s path 

To terminate EDM editing and 
save the edited copy, path can 
give the directory and the entry 
name within the directory under 
which the segment is to be saved. 

If only the entry name for the 
saved copy is given, the working 
directory is assumed. 

A blank between s and path is 
not sign if icant . 

If path is null and if the origi- 
nal name of the segment is not null, 
the edited segment is saved under 
the original name; the original seg- 
ment is deleted. If path is null 
and no previous segment exists, an 
error message is printed and EDM 
looks for another request. 

To terminate editing without 
saving the edited copy, see q 
(QUIT) request. 



a: procedure; 
x = yj 

q = r; 

s = t; 

end a; 



c /,*/ (y ,r)j/ 
s 

a: procedure 

x = y; 
q = rj 

s = tj 
end a; 




Ed i ted 
file is 
retained. 
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TOP : 
Format : 
Purpose: 



t 

t 



Pointer : 
Note: 



Examp le: 
Bef ore : 



Request : 
After: 



Moves pointer to first line 
of segment. 

At first line of text. 

An i (INSERT) request immed- 
iately following a t request 
causes insertion of a text 
line at the beginning of segment. 
See INSERT. 



a: procedure; 
x = y; 
q = r; 

-> s = t; 
end a; 
t 

-> a: procedure; 

x = y; 

q = r; 
s = t; 
end a; 
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EDM REQUESTS 




VERBOSE: 


V 




Format : 


V 


i 


Purpose: 


Causes EDM to print out 
responses following an f, 1, 
or c request. The default 

EDM mode is VERBOSE. 


Pointer: 


Unchanged. 




Note : 
Example : 


See k (KILL) for inhibiting 
VERBOSE mode. 




Bef ore: 


a: procedure; 

x = y; 

-> q = rj 
ss= t; 
end a; 




Requests : 


V 

c/ ss=/ s =/ 




Response : 


s ~ t; 




After: 


a: procedure; 

x = y; 

-> q = r; 
s - t; 
end a; 


• 
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Q.ED REQUESTS 

REQUEST MEANING 


REQUEST 


absolute line address 


: 


append 


a 


buffer 


b 


change 


c 


current line address 


= 


delete 


d 


enter 


e 


exclude 


V 


global 


g 


insert 


i 


list 


1 


move 


m 


print 


P 


quit 


q 


read 


r 


sort 


k 


status 


X 


subst i tute 


s 


transf orm 


y 


write 

• 


w 
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QED REQUESTS 

Q.ED EDITOR 

The qed editor performs operations on text in a 
working space called a buffer. A buffer contains 
zero to any number of lines of text, and there may 
be any number of buffers. Each buffer is identified 
by a name. There is one current buffer; all other 
buffers are auxiliary buffers. 

BUFFER NAMES 

The buffer name can be any length but only the 
last five characters are significant. Generally, 
buffers are named with a one to five character 
name enclosed in parentheses. If the name is 
one character long, and not a carriage return 
or apostrophe, the parentheses can be omitted 
(e.g., buffer names X and (X) are identical.) 

TEXT ADDRESSING 

QED accepts commands and text as a stream of 
characters from the console. Text within the 
current buffer is specified by (l) line addresses 
or (2) str ings (regular-expressions) in the text 
1 ine. 

Lines in the current buffer may be addressed in 
the following ways: 

1 • by current line number 

A decimal number not beginning with !l 0 n or an 
octal number beginning with M 0 n is interpreted 
as a current (relative) line number. The first 
line is numbered 1, the second 2, the tenth line 
10 or 012, etc. This number may change during 
editing. Example: 

3,6 p 

means print lines 3 to 6, inclusive. 
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Q.ED REQUESTS 
TEXT ADDRESSING (CONT.) 

2. bv absolute line number 

The character 1 (apostrophe immediately 
followed by a decimal number (or octal 
number beginning with "0") is interpreted 
as an absolute line number. This number is 
assigned to each line in the current buffer 
when the text is initially read into the 
buffer from a segment. These line numbers 
never change except after read requests 
(which cause a new set of absolute line 
numbers to be assigned to text in the 
buffer). New lines created during editing 
have undefined absolute line numbers. 

The character "'" not followed by a digit 
causes a search for the first undefined 
absolute line after the current line. 

(The search is cyclic from the line after 
the current line to the current line.) 

If there is no line with the given 
absolute line number an error message is 
printed on the console (see "Diagnostics")* 
Example: 

'53 p 

means print the text on the line designated 
by absolute line number 53. 

3. bv the value of the current line (".") 

The character ".". (period) in a QED address 
means the value of the current line. This 
value is changed by most edit requests. 
Example: 

•P 

means print the current line. In the 
examples provided for each request an 
arrow (<-) indicates the position of "." 

(the value of the current line). 
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(CONT.) 



4. bv the special char acter "I" 

The value of $ in an address is the last line 
of text in the buffer. This value may change 
during editing. Example: 

1,1 p 

means print all lines from line 1 to the last 
1 ine. 

5. by context 

The string./ regular expression/, causes a 
search by QED to match regular expression in 
the text. The search begins at the line 
after the current line and cycles to the 
current line. If the search is successful, 
the first occurrence of regular expression 
(in the direction searched) has been located. 
Example : 

/ x =2y/ p 

causes the first line of text containing 
"x=2y" to be printed and causes (current 
line pointer) to be set at that line. 

6. by additive combinations o f methods 1. to 5 . 

An address followed by + or - followed by 
another address (normally relative line 
number or regular expression) can be used to 
address a 1 ine. 

40+4 p print line 44 

/xyz/-5 print a line five lines before the 
line containing the regular 
expression, xyz. 
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REGULAR EXPRESSIONS 



Conventions used in writing regular expressions in 
QED can best be shown by examples. These are: 

/a/ matches letter "a" anywhere on a line. 

/abed/ matches string t! abcd !t anywhere on a line. 
/ab*c/ matches strings "ac", "abc", "abbe", "abbbe", . . . 
/abcldef/ matches string "abc" or string "def". 
/(i|o)nto/ matches strings "into" and !! onto !t . 

In addition, the characters "“ 1 ", and "$" have 

special meaning. The character " " matches the 
zeroeth character on a line. The character "$" 
matches the character after the last character on a 
line. The character !! . !! matches any character on a 
line. For example : 

/.*/ matches an entire line regardless of length, 
/-■begin |end$/ matches a line beginning with "begin" 
or ending with "end". 

/in.*to/ matches a line containing "in" and "to" in 
that order. 

/ n beg.*end$/ matches a line starting with "beg" and 
ending with "end" . 

/^$/ matches a blank line. 

/rv is an illegal combination matching nothing. 



A number of QED requests are followed by literal text 
input. This text must be preceded by a space or a 
carriage return. The text consists of any string of 
characters terminated by \f. The \f is not part of 
the text but delimits end of text; \f is used at the 
beginning of the next line following the last charac- 
ter in the body of the text. 

ESCAPE CHARACTERS 

Standard Multics escapes are used. See INPUT STREAM 
section. , „ . ^ 
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QED REQUESTS 

DIAGNOSTICS 

01 Regular Expression search failed. 

02 Unrecognized request or address. 

03 Regular Expression syntax error. 

04 Address syntax error. 

05 Address wrap around. 

06 Address out of buffer. 

07 Abs line search failed. 

08 File system error. 

09 Request syntax error. 

16 Unknown Regular Expression type. 

17 Out of memory. 

18 Overflow on store. 

19 Passed EOF on store. 

20 Free of block 0. 

(Diagnostics 16 to 20 are fatal.) 
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ABSOLUTE LINE NUMBER : 

Format: adr i : 

/regular_expression/ : 

Purpose: Prints absolute line number of 

the line addressed. 




!l . n value: set to the addressed line. 



Note: If the absolute 


1 ine number is 


undefined, a "?" 


is typed. 


Example: 


Buffer Contents 


Absolute line number 


x = y; 


'51 


if y<10 


'52 


GO TO PROC A; 


'53 



Requests: 

/<10/d 

/PROC/: 

Results: 

1 53 

Even though line 52 is deleted the 
absolute address is the same as it 
was when the line was created, i.e., 
absolute lines are not changed by 
editing. 
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APPEND 
Format : 

Purpose: 

" value: 

Def ault : 
Example: 



QED REQUESTS 
a 

adr a or /regular expression/ a 
text text 

\f \f 

To append text after the line 
addressed. 

Pointer set to last line appended. 
If no lines were appended, is 
set to the line addressed. 

a is the same as .a 



Bef ore: 

a: procedure; Line 1 

x = y; Line 2 

end a; Line 3 

Request : 

2a or /y/a 
9 = r; q = r; 

\f Vf 

After : 



procedure 


Line 


1 


x = yj 


Li ne 


2 


q = r; 


Line 


3 <- 


end a; 


Line 


4 
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Q.ED REQUESTS 



BUFFER b 

Format: bx 

where x is the name of a buffer. 

Purpose: To make the current buffer an 

auxiliary buffer, and to make 
x the current buffer. If buffer 
x does not exist it is created. 

Initially, buffer 0 is the 
current buffer. 

"•"value: Line pointer unchanged in each 
buffer. 

Examp 1 e : 

Bef ore: 

Buffer 2 is the current buffer. 

"." is at line 2 in buffer 2. 

Buffer 3 was previously the 
current buffer; at that time, 

"." was at line 3 in buffer 3* 

Request: 

b3 

After: 

Buffer 2 is an auxiliary buffer, 
and buffer 3 is the current 
buffer. "." in buffer 3 is 
at line 3- 

If the request b2 is issued later, 
buffer 2 will be the current 
buffer, and "." will be at line 2 
in buffer 2. 
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QED REQUESTS 



CHANGE 

Format: 

Purpose: 



adrl .adr2c 
text 

\f 

To delete the lines specified by adrl 
through adr2 and to substitute (input) 
other text for the deleted lines. 

(The 1 ine number specified by adrl must 
not exceed adr2 .) 

"."value: Line pointer is set to the last line of 

the text. If no lines of text are substi- 
tuted (input), "." is set to the line 
before the first line deleted. 

adrlc is the same as adrl . adrl c 



Default : 
Note: 

Example: 



c is the same as .c 

adr2 must be greater than or equal to adrl 
(i.e., the addressed lines cannot cross 
zero cycl icly .) 



Before : 



Request : 



procedure; 

x = y; 

q = r; 
end a; 



Line 1 
Line 2 
Line 3 
Line 4 <- 



2,3c or 


/x/,/q/ 


s = t; 


s = t; 


u = v; 


u = v; 


w = z; 


w = ZJ 


\f 


\f 


After: 


a: procedure 


Line 1 


s = tj 


Line 2 


u = v; 


Line 3 


w = z; 


Line 4 


end a; 


Line 5 
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Q.ED REQUESTS 

CURRENT LINE NUMBER = 

Format: /regular express ion/= 

Purpose: Prints current value of a line, 

value: Set to the addressed line. 



Default: = is the same as 

Example: 


#= 




BUFFER CONTENTS 


CURRENT LINE 


NUMBER 


A:procedure; 


0001 




declare x fixed bin(lV); 


0002 




a=b; 


0003 




y-x; 


0004 




X 

II 

X 

+ 

N* • 


0005 




end A; 


0006 


<- 


The current line is line 


6 and the request: 





causes: 

0006 

to be printed at the console, and the value 
of ” ." remains at 0006. 

Similarly, the request: 

/y=x/= 

causes: 

004 to be printed at the console and the 
value of is set to 0004* 
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DELETE 

Format: 

Purpose: 

value: 
Default : 

Note: 

Examp 1 e : 






QED REQUESTS 
d 

adrl . adr2 d 

To delete the lines specified by 
adrl through adr2. (The line 
number specified by adrl must 
not exceed adr_2. ) 

Line pointer is set to the line 
after the last line deleted. 

adrld is the same as adrl . adr I d 

d is the same as . d 

adr2 must be greater than or equal 
to adrl. (i.e., the addressed lines 
cannot cross zero.) 



Bef ore: 


a: procedure; 


Line 1 


x = y; 


Line 2 


q = r; 


Line 3 


s = t; 


Line 4 


end a; 


Line 5 


Request : 


3,4d or 


/ q/ >/s/d 


After: 


a: procedure; 


Line 1 


x = y; 


Line 2 


end a; 


Line 3 
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QED REQUESTS 
ENTER e 

Format: e/ regular expression/name/ 

Purpose: To tag a regular expression 

with a specified name. If the 
same name is used in several 
ENTER requests, the most recent 
request takes precedence. 

Examples: 

In sequence A; the SUBSTITUTE request 
replaces regular expression, henry with the 
string, aldrich. In sequence B, the 
SUBSTITUTE request replaces regular expres- 
sion whose tag is henry, i.e., alpha, with 
the string, aldrich. < > symbols indicate 
that the string enclosed is a tag. 



Sequence A 

Buffer Contents: 

alpha = henry; 

Request Sequence: 

e/alpha/henry/ 
s/henry/ aldr i ch/ 



Sequence B 

Buffer Contents: 

alpha = henry; 

Request Sequence: 

e/alpha/henry/ 
s/<henry>/ aldr i ch/ 



Buffer Contents: 
alpha = aldrich; 



Current Line: 

aldrich = henry; 
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EXCLUDE v 
Format: a 
Purpose: T 



value : 
Default : 

Note : 
Example: 



taining re gular expression . 

The following are the only legal construc- 
tions for the exclude request: 
adrl , adr2 ya text/ regexp/ 
adrl . adr2 vc text/ regexp/ 
adrl , adr2 vd / regexp/ 
adrl . adr2 yj text/ regexp/ 
adrl . adr2 vm bufnam/ regexp/ 
adrl , adr2 yp /regexp/ 
adrl , adr2 vs /re gexp/string/regexp/ substitute 
adr 1 , adr2 yy / str ing/ str ing/ transform 

adrl , adr2 v: /re gexp/ absolute line 

adrl , adr2 y- / regexp/ current line 

Pointer is set according to the request . 

v request request parameters is the same as 

1 ,lv request request parameters 

Because of the nature of the exclude re- 
quest, the request parameter, regexp . 
is required for the move request. 

Before: 

abed 
e f g h 
d e f h 

Request: 1,$vp/d/ 

Result: e f g h 

t 



append 

change 

delete 

insert 

move 

print 
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GLOBAL 
Format : 
Purpose: 




value: 
Default : 

Note: 

Purpose: 




QED REQUESTS 

g 

adrl . adr2greauest request parameters 



To execute a given r equest on all lines 
addressed. 

The following are the only legal construc- 
tions for the global request. 



adrl . adr2g a 
adrl , adr2g c 
adrl . adr2g d 
adrl , adr2g i 
adrl , adr2g m 
adrl . adr2g p 
adrl . adr2p s 
adrt . adr2g v 
adrl . adr2g : 
adrl . adr2g = 



text/ regexp/ 
text/ regexp/ 
/re gexp/ 

j fexp/ 



append 

change 

delete 

insert 



move 



text/ regexp/ 
buf nam/regexp/ 

/regexp/ print 

/ regexp/str ing/ regexp/ substitute 
/str ing/str ing / transform 

/re gexp/ absolute line 

/ regexp/ current line 



Pointer is set according to the request . 

grequest request parameters is the same as 

1 .^L request request parameters 

Because of the nature of the global request, 
the request parameter, regexp , is required 
for the move request. 

Before: 

abed 
e f g h 
d e f h 

Request: 1,$gp/d/ 

Result: abed' 

d e f h 
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INSERT 

Format: 

Purpose: 

value: 

Default: 

Examp 1 e : 



QED REQUESTS 
i 

adrl i text 

\f 

QED accepts text which is inserted 
before adrl in the current buffer. 

Line pointer is set to adrl . 

i text 

\f 

is identical to: 

. i text 

V* 

Before: 

BUFFER CONTENTS RELATIVE ADDRESS 

a: procedure; 1 

x = y; 2 

end a; <- 3 

Request: 

3 i 

a = b; 

if x = b then y = a; 

\f 

After : 



BUFFER CONTENTS RELATIVE ADDRESS 

a: procedure; 1 

x = y; 2 

a = b; 3 

if x = b then y = a; 4 
end a; <- 5 
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Q.ED REQUESTS 




LIST 

Format: 

Purpose: 



" value: 
Note: 



1 

1 type segnam 

To read and print the Multics 
segment specified by segnam . 

Only one type is currently recognized; 
this is: 

<sp> asci i 

therefore, the type parameter is 
is left null. 

is unchanged 

A space must appear after 1. 



Examp 1 e : 



The segment, joe. ascii, is a Multics 
segment in the working directory of 
the user. 



Request: 1 joe. ascii 

The contents of joe. ascii are 
then printed out on the console. 



Result of request: 
test: proc; ^ 

x = l; 

y = x+1 ; * 

end test; 



contents 

of 

joe. asci i 
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m 



MOVE 

Format: adrl . adr2 mx 

Purpose: To replace all the contents of buffer x 

with lines from the current buffer from 
adrl to adr2. adrl must be less than 
adr2 . adrl through adr2 are deleted from 
the current buffer. The MOVE request 
causes buffer x to become the current 
buffer. If buffer x is already the cur- 
rent buffer, all contents of x except lines 
specified in MOVE are deleted. 

value: Line pointer is set to the line after the 
last line moved in the current buffer and 
set to the last line moved in buffer x. 

Default: adrlm x is the same as adrl . adrlm x 

mx is the same as . mx 

Examp le: 

Before: 

CURRENT BUFFER L 

a: proc; Line 1 
b = c; Line 2 
e: proc; Line 3 
f = g; Line 4 
end e; Line 5 
end a; Line 6 

Request: 3,5mK 

After: 

BUFFER L 

a: proc; Line 1 
b = c; Line 2 
end a; Line 3 



CURRENT BUFFER K 

e: proc; Line 1 
f = g; Line 2 
end e; Line 3 



BUFFER K 

c: proc; Line 1 
j = k; Line 2 
end c; Line 3 
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QED REQUESTS 
PRINT p 

Format: adr1 . adr2p 



Purpose: To print the lines specified by adrl 

through adr2 . (The buffer is un- 
changed.! 

value: The line pointer is set to the last 

line pr inted. 

Default: adrl p is the same as adrl . adrl p 

p is the same as .p 

adrl followed by a carriage return is 
the same as adrl p 

0. Hitting the carriage return 
prints the current 1 ine. 

/regular express ion/ (c^ prints the 
first line in the buffer (after the 
current line) which contains the 
regular expression. 



Example: 



Contents of Current Buffer: 



procedure} 


Line 


1 


x = y; 


Line 


2 


q = r} 


Line 


3 


s = t; 


Line 


4 


end a} 


Line 


5 



Request: 2,4p or /x/,/s/p 

Result: 



The following 



is printed: 



x = y; 
q = rj 
s = tj 
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QUIT 

Format: 

Purpose: 

Note: 



QED REQUESTS 

q 

q 

To return to Multics command level; 
or to return from QED to the process 
which called QED. 

The q request does not determine 
whether or not the buffer is saved. 
To save a buffer, the contents 
must be written into a Multics seg- 
ment using either the w (WRITE) 
request or the optional argument 
in the QED command, output_file. 
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READ 

Format: 

Purpose: 



lat: adrlr type sepnam 

)ose: To read the Multics segment whose name 

is specified by sepnam and to append the 
segment after the line addressed. A 
space must appear between r and type . 

Only one type is currently recognized. 

Th is is : „ v 

<sp> asc 1 1 

Therefore, the type parameter may be null. 

value: Line pointer is set to the last 

1 ine read. 

lult: r type sepnam is the same as 

$r type sepnam 



Bef ore: 

a: procedure; 

x = y; 
end a; 

Request: 

2r joe.asci i 

where joe.asci i is 

b: procedure; 
c = d; 
end b; 

Af ter : 



Line 1 
Line 2 
Line 3 <- 



procedure; 


Line 


i 


X = 


y» 


Line 


2 


procedure; 


Line 


3 


c = 


d; 


Line 


4 


end 


b; 


Line 


5 


end 


a; 


Line 


6 
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SORT 
Format : 
Purpose: 



Q.ED REQUESTS 



k 

adrl « adr2k 

To sort the lines specified 
by adrl through adr2 in ascending 
ASCI I collating sequence, adrl 
must be less than adjr2. 

value: Line pointer is carried with the 

sorting; it may change value but 
it points to the same line of text. 

Default: adrlk is the same as adrl , adr1k 

k is the same as 1,$k 

Example: 

Current Buffer Before: 

alpha beta gamma <- 

abcde 

bcdef 

bdcef 

zxywx 

zabcd 

12345 

Request: k 

Current Buffer After: 

12345 

abcde 

alpha beta gamma <- 

bcdef 

bdcef 

zabcd 

zxywx 
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Q.ED REQUESTS 



STATUS x 

Format: x 



Purpose: 



value: 

Example: 



To cause the following information 
to be 1 isted: 

Name of current buffer. 

Value of (current line). 
Length of current buffer. 

Name and length of all non-zero- 
length auxiliary buffers. 

Names of all named regular 
expressions (see the Enter 
Request). 

Line pointer is not changed. 

In a QED run buffers 0,2, and 
1 were mentioned in that order 
in BUFFER (b) requests. Regular 
expressions alpha and aldrich were 
given names. The current buffer 
is 1 . 

Request: x 

Result: 

" 1 " 0018 0020 
" 2 ” 0001 
"0" 0006 
alpha 
aldr ich 
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Q.ED REQUESTS 



SUBSTITUTE 
Format : 
Purpose: 



value: 



Def au It : 



s 

adrl . adr2 s/ regular expression/ string/ 

To replace all occurrences of an 
expression ( regular expression) in 
the addressed lines with a new 
expression ( string) . 

Line pointer is set to the last line 
substituted, or left unchanged if 
SUBSTITUTE finds no matching lines. 

adrl s/ regula r expression/string/ 
i s the same as 

adrl . adrl s/ regular expression/string/ 



s/ regular expression/string/ 
is the same as 

. s/ regular expression/string/ 

Example: 



Before: 



a: procedure} 
x = y; 
x = Z} 
end a} 

Request: 

2,3s/x/t/ or 

Af ter : 



a: procedure} 
t = y; 

end a; 



Line 1 
Line 2 
Line 3 
Line 4 <- ' 



/ y/ ,/ z/ s/ x/ 1/ 
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TRANSFORM y 

Format: adr1_,adr2y/str ingl/str ing2/ 

Purpose: To replace occurrences of characters in 

str ing l with the corresponding character 
of str ing2 . str inpl and str ing2 must be 
of the same length; no character may 
appear twice in str inpl . 

value: Set to the last line transformed. 

Default: adrlv / str ingl /str ing2/ 

is the same as 
adrl .adrlv / str ingl/ str ing2/ 

v/ str inpl /str ino2/ 
is the same as 
.v/ str ingl/str ing2/ 

Example: Current Buffer Before: 

AAAAAAA 

Aardvaark 

ABA 

ABAFT 

ABB 

ABBACY 

Request: 

1 , $y/ ABC/ abc/ 

Current Buffer After: 

aaaaaaa 

aardvaark 

aba 

abaFT 

abb 

abbacY <- 
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w 



WRITE 

Format: 

Purpose: 



" . " value: 
Default: 

Examp 1 e : 



adrl . adr2w type segnam 

To write the addressed lines into 
the segment <segnam>. 

Only one type is recognized. 

This is: 

<sp> asci i , 

therefore, the type parameter may 
be nul 1 . 



A space must appear between w 
and type (or segnam). 

Line pointer is unchanged. 

w type segnam 

is the same as 

1 ,#w type segnam 

Request: 2,3w sam. ascii 

Result: 

The second and third 
lines of the current 
buffer are written into 
the segment sam. ascii 
in the user's working 
directory. 






VI -26 Rev 2 06019 





PROBE REQUESTS 

argl i st 

dump_process 

info 

initiate 

output 

qu i t 

segdump 

segi nf o 

set 

stack 

state 

terminate 



Probe requests perform the following functions: 




1. Direct output from probe to a standard stream 
(console), or direct output to a user specified 
segment. 

2. Dump machine conditions and register contents. 

3. Dump all or part of a segment. 

4. Dump the contents of an entire process directory. 

5. Print size, access, and date of creation 
information for one segment or a group of 
segments. 

6. Print a stack trace for a process. 

7. Print argument list for a stack frame. 

8. Make a segment known or unknown to the system. 

9. Print a summary of available probe requests. 

10. Make an octal patch to a segment. 




VI 1-1 Rev 2 06019 




ARGL I ST 

Format : 
Purpose : 



Examp lei : 



Examp le2 : 

i 



PROBE REQUESTS 



arglist stack f rame 

To print an argument list for the 
specified stack frame. 

stack is the name or number of the stack 
segment 

f rame is the name of the "owning procedure" 
or starting offset of a stack frame. 

If stack is not given, the current stack 
is assumed; the argument list for the last 
occurrence of f rame in the current stack 
is printed. 

arglist 4760 

Might cause the following to be printed 
for frame 4760 in the current stack: 



arg_1 


fixed, bin 




26 


arg_2 


varying character string 




"no_comment_ necessary" 


arg_3 


bit string 




1 260 



arglist stackjOO gim 

The example presumes operation in a 
ring other than ring 0. Therefore, 
the ring 0 stack is given, followed by 
the requested frame. 
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DUMP PROCESS 





Format: dump_process process_i d 

Purpose: To obtain an octal dump of each segment 

in the process whose unique identifier 
is given by process_i d . The unique 
process_i d may be given in octal or as 
a character string. If no argument is 
given, an octal dump of the current 
user process will result. 

Note: Normally, output will be directed by 

the use of the output request to a 
segment for later printing. 

Example: - dump_process 
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PROBE REQUESTS 



INFO 



Format: info 



Purpose: 



t 



xamp 1 e : 



To provide a complete list of probe 
requests with pertinent parameters 
and options and provide an abbrevi- 
ated explanation of the request f s use. 

- info 



See BX.10.00A for complete descriptions. 
The following requests are available: 



argl ist 
inf o 

initiate xxx 
output p -xxx- 
segdump xxx 
segments -xxx- -xxx- 

segstatus xxx 

stack -xxx- -yyy- 

terminate 

qu i t 



- list of stack frames 

- obtain this listing 

- make a segment known to process 

- direct to a specific medium 

- part of a segment in octal 

- print information about a 
group of segments 

- print information about 
one segment 

- print a stack trace of segment 
starting with frame yyy 

- make a segment unknown to 
process 

- return to command level 



Note: The current info printout shown above is not 

complete and will probably change shortly. 
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INITIATE 



initiate path ref erence 

To make the segment given by path 
known to the process being debugged by 
the reference name given by reference . 

If ref erence is not givenjthe entry name 
of the segment will be used. 



initiate bin_oct 

Segment bin_oct initiated. Number 41 
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OUTPUT 
Format : 



Purpose : 



Note: 



PRORF REQUESTS 



output console 
output segment path 

output console -directs output from 

probe request to 
the console. 

output segment path- di rects output to a 

segment whose path- 
name i s path . 

By default, output of probe requests is 
printed on the console. The output 
console request need only be issued 
after a previous output segment path. 



Example: probe 

W 924:09.4 

- output segment text_prog (request) 

Output directed to segment text_prog. 
Number 227 (response) 

- state (The output of probe request, 

state, is to text_prog in 
the user's working directory.) 

- output console (Subsequent probe 

request to redirect output to 
the console. ) 
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PROBE REQUESTS 

QUIT 

Format: quit 

Purpose: To stop processing probe requests 

and return to Multics command level. 

Examp 1 e : 

- quit 

r 5:04.0 19.2 40 
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SEGDUMP 

Format : 
Purpose : 



PROBE REQUESTS 

segdump seg lower upper 

To produce an octal dump of the segment 
seg from the lower bound specified by 
lower to the upper bound specified by 
upper . seg is the segment name or an 
octal number which designates a segment 
in the KST. 

If the parameter upper is not specified, 
the segment is dumped from lower to the 
current length of the segment. 

If neither parameter is specified, the 
entire segment is dumped. 

If the segment is not known to the 
process, the comment: segment not yet 
initiated is printed. 



Note ; 



Example : 

- segdump 203 1700 1777 

Segment multics 000203 

001700 000114352000 VI 007 

600556350100 60CJ 1120 

001710 600560252100 oof fioo 

600556757100 6(J *7100 

001720 000222352000 6(1 J2000 

010000431007 60\ 10100 

001730 400064710120 ooq v 100 

600024357100 400^ vooo 



H 001740 


000242352000 


6003 


f07 




6005563 50100 


6ooy 


120 


0U1750 


600560252100 


00J 


poo 




600556757100 


6(7 


f 100 


001760 


000232352000 


6q 


/ 2000 




010000431007 


6a 


fiOlOO 


001770 


400070716120 


oo\ 


*2100 




600562252100 


01 (J 


\7100 



600556757100 

000226352000 

010000431007 

400062710120 

600562252100 

600024357100 

6005563 50100 
600560252100 

600556757100 

000232352000 

010000431007 

400070710120 

600562252100 

600024357100 

000264352000 
6005563 50100 
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SEGINFO 

Format: 

Purpose: 



Example: 

§ 



PROBE REQUESTS 



seginfo segl seg 2 all long 

To print a list of segment names and num- 
bers known to the process from segment segl 
through segment seg2 . 

segl and seg2 are either segment names or 
numbers known to the process being debugged. 
If seg2 is blank, a list of all segments 
from segl are printed. If both segl and seg2 
are blank, names of all segments known to 
the process are printed. Source of informa- 
tion for the list is the KST. 

all is an optional literal causing all the 
reference names for each listed segment to 
be printed. (A reference name is a name in 
the KST by which a segment is known to a 
process) . 

long is an optional literal causing the fol- 
lowing information to be printed for each 
listed segment: current length, access modes 

and date created. 

If a request is: seginfo 

a list of all segments known to the process 
being debugged is printed. 

Any combination of parameters to the seginfo 
request is permissible, except use of seg2 
without a preceding segl . 

seginfo 200 test_proc long 
Results: 

200 root>sys_root>sys 1 ib>cv_str ing. 1 ink 

1 r ewa 1 2731/68 1900.0 EST MON 

201 root>sys root>sys_l ib>get_count 

8 re 12731/68 1900.0 EST MON 

202 root>sys_root>sys 1 ib>sys_info. 1 ink 

1 re 12/31/68 1900.0 EST MON 
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SET 



PROBE REQUESTS 



Format : 



set seg l location valuel 



value2 . . . . 




Purpose: To place values beginning with valuel 

in the segment given by seg . beginning 
at the location given by locat i on . 
valuel is placed in locat ion . value2 
in location+1, etc. At least one value 
must be present. The request allows 
octal patching of segments for which 
the user has write permission. 

Notes: seg may be a symbolic name or segment 

number. 



Example: set 20311700 000224251000 600525210000 

where the values given replace the 
current values in locations 001700 
and 001701 of the segment numbered 203 . 
Probe prints out the values before and 
after the change. 
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PROBE REQUESTS 



STACK 

Format: stack seg f rame f args 

Purpose: To trace the sequence of calls in stack seg- 
ment seg starting at location frame, seg may 
be a segment number or name. If f rame is gi- 
ven in octal, it is interpreted as a frame 
number. If f rame is given as a segment name, 
the stack is examined for a frame belonging to 
the segment. Tracing starts at that frame. 

Default tracing is from end to beginning of 
the stack through ring-crossing frames. Op- 
tional literal f causes tracing to proceed 
from beginning to end, terminating when a 
ring-crossing frame is encountered. 

If neither seg nor f rame are given, the cur- 
rent stack is assumed, seg must be given if 
f rame is given. If f rame is not given, trac- 
ing proceeds from either the beginning or end 
of stack as appropriate. 

Optional literal args causes a list of all argu- 
ments passed to each stack frame to be printed. 



For each 


frame, the name 


and number of the 


segment 


using the frame, 


start ing 


location in 


the stack segment, and frame size 


are printed. 


- stack 


- 






stack trace of segment stack_01 . 1 


Number 0001 71. 


Number 


Name 


Start 


Size 


0226 


probe '1314 


003540 


0170 


0226 


probe 1 223 


003410 


0130 


0225 


shel l_char \l±2/+2 


002150 


1240 


0225 


shel l_char | 1 075 


001610 


0340 


0225 


signal |464 


001340 


0250 


0011 


f im (56 


001160 


0160 


0203 


mult ics i 1 747 


000310 


0650 


0206 


bi t_to| 2147 


000220 


0070 


0203 


mult ics | 31 53 


000050 


0150 


0000 


nocall ! 0 


000010 


0040 
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PROBE REQUESTS 



STATE 






Formats: 


Request 


Meaninp of Request 


state 


ar i th 


Print contents of A, Q, and 
exponent registers. 


state 


bases 


Print contents of 8 base 
registers. 


state 


cun it 


Print control unit contents 
and ring number. 


state 


index 


Print contents of 8 index 
registers. 


state 


location 


Print the fault location and 
the computed address. 


state 


t imer 


Print contents of timer 
register. 


state 




Print all of the above. 



Purpose: To print the available status informa- 

tion for the process being debugged. 

Example: -state 



m: 000004000000 Q: 

Exponent : 000000000000 

Timer: 430351270000 

Fault at 20311746 
Effective address 201 j 162 
Index registers: 3 0 

Base registers: 

ap: 001066100000 ab: 

bp: 000242300000 bb: 

lp: 000072500000 lb: 

sp: 000310700000 sb: 

Control unit: 

000201022001 000162000200 
000162710120 000232352000 
Ring: 001 



000000000000 

Indicator: 10 



0 0 171 0 410 66 

0001 71040000 
000203040000 
000201 040000 
000171060000 

000203200700 001746001000 
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TERMINATE 




Format : 
Purpose: 




terminate path 

To make the segment given by path 
unknown to the process by removing it 
from the KST. 

/ 

terminate bin_oct 
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GENERAL 



ELECTRIC 





